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PRINTING HISTORY 


New editions are complete revisons of 
the manual. Update packages, which are 
issued between editions, contain 
additional and replacement pages to be 
merged into the manual by the customer. 
The- data on the title page and back 
cover of the manual changes only when a 
new edition is published. When an 
edition is reprinted, all the prior 
updates to the editions are 
incorporated. No information is 
incorporated into a reprinting unless it 
appears as a prior update. The edition 
does not change. 


The software product part number printed 
alongside the date indicates the version 
and update level of the software product 
at the time the manual edition or udpate 
was issued. Many product updates and 
fixes do not require manual changes, and 
conversely, manual corrections may be 
done without accompanying product 
changes. Therefore, do not expect a one 
to one correspondence between product 
updates and manual updates. 


First Edition.......... 
Update: sa.0 S65: ose eeu 
Second Edition....... 


The second edition of the DSG/3000 
Manual incorporates several new enhance- 
ments which reflect the increased power 
of the program, whether it is run inter- 
actively or programmatically. 


A range of new text fonts, text sizes 
and choices of colors allows for im- 
proved chart design. Native language 
characteristics for several languages 
are available to users. 


Figure files may be created which 
make DSG/3000 charts available for use 
with HPDRAW, TDP/3000, HPMAIL and the 
HP2680A (Laser Printing System). 


New peripheral devices have also been 
added to the list of those supported by 
DSG/3000. PASCAL has been added to the 
list of supported languages. 
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CONVENTIONS USED IN THIS MANUAL 


DESCRIPTION 


An element inside brackets is optional. Several elements stacked inside a pair of brackets means 
the user may select any one or none of these elements. 


Example: a user may select A or B or neither 


When several elements are stacked within braces the user must select one of these elements. 
A 

Example: B } user must select A or B or C. 
C 


Lowercase italics denote a parameter which must be replaced by a user-supplied variable. 


Example: CALL name 
name one to 15 alphanumeric characters. 


A horizontal ellipsis indicates that a previous bracketed element may be repeated, or that elements 
have been omitted. 


When it is necessary to distinguish user input from computer output, the input is underlined. 
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Preface 


Decision Support Graphics/3000 
(DSG/3000) is designed to produce 
graphic displays of data. It operates on 
the HP 3000 computer system. 


DSG/3000 provides these capabilities: 


o design of pie charts, bar charts, line 
charts and scattergrams 


o data input from any suitably formatted 
MPE file 


o interactive chart design and 
production through screen menus 
requiring no programming 


© programmatic chart design and 
production through procedures callable 
from COBOL, BASIC, FORTRAN, PASCAL, 
and SPL 


Xiv 


DSG/3000 can be used by anyone who 
wishes to design or produce graphs from 
data stored in the HP 3000. Graph 
designers may be managers, admin- 
istrators, or other personnel with 
or without programming experience. 
non-programmer can perform the same 
functions interactively as a pro- 
grammer writing in one of the above lan- 
guages. 


The 


In order to use DSG/3000, you should 
know how to operate the terminals and 
plotters used at your facility. If you 
use the programmatic interface, you may 
also need the manual for the language in 
which you code. 


You may wish to consult the following A self-paced course, Using Decision 
manuals: Support Graphics/3000, product number 
22833A, is also available. 


Manual Part Number 
DSG/3000 Guide 32250-90002 
Using the HP 3000 03000-90121 
MPE Commands Reference 

Manual 30000-90009 
MPE Intrinsics Reference 

Manual 30000-90010 
Using Files 30000-90102 
VPLUS/3000 Reference 

Manual 32209-90001 
QUERY /3000 Reference 

Manual 30000-90042 
EDIT/3000 Reference 

Manual 03000-90012 
BASIC/3000 Interpreter 

Reference Manual 30000-90026 
BASIC/3000 Compiler 

Reference Manual 32103-90001 
FORTRAN/3000 Reference 

Manual 30000-90040 
SPL/3000 Reference 

Manual 30000-90024 
PASCAL/3000 Reference 

Manual 32106-90001 
Text & Document 

Processor/3000 36578-90001 


And those manuals associated with your 
terminals and plotters. 
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HOW 70 USE THIS MANUAL 


Because this manual must answer the 
needs of inexperienced users as well as 
programmers, its contents range from 
very basic to highly detailed informa- 
tion. Section 1 need only be read by 
those who are unfamiliar with graphs and 
with the equipment needed to operate 
DSG/3000. Section 2 provides explana- 
tions of concepts and terminology which 
are referred to throughout the manual. 
It is essential to the new user, and 
will provide review materials for those 
who use DSG/3000 infrequently. 


Section 3 covers the six methods of 
creating data files and will aid you in 
making decisions as to how you wish to 
handle yours. Only those who plan to use 
DSG/3000 interactively need to read 
Sections 4 and 5, while programmatic 
users will rely on Sections 6 and 7 

for information. A brief description of 
the contents of each section follows. 


Section 1, Introduction, contains 
general information about DSG/3000 
including examples of basic graphs that 
you may create, a list of features and 
their uses, and illustrated overviews of 
the subsystem's components. It 
concludes with a discussion of a typical 
graphics terminal keyboard and 
information about plotters and printers 
supported by DSG/3000. 


Section 2, Graphing Terms and 

Concepts, familiarizes the reader with 
the purpose of graphs, how to select a 
graph type for a particular use, and 
terminology associated with graphing. 
Numerous examples point out the enhance- 
ments available which increase the ef- 
fectiveness of a graph. 


Section 3, Creating a Data File, 
describes the six methods available for 
declaring the values of your input data. 
Because a data file must exist before a 
graph can be drawn, this section pre- 
cedes those which focus on creating the 
graph. The methods range from highly 
interactive to programmatic use. 


Section 4, Using Graph Interactively, 

is devoted to running the interactive 
program, GRAPH. It covers the use of 
the special function keys, logging on, 
characteristics of the program and the 
screen display. It concludes with a gen- 
eral introduction to the screen menus, 
menu loops, and how menus are used in 
designing, enhancing, and modifying a 
chart. 


Section 5, Menu Specifications, lists 
alphabetically all the menus and legal 
entries for all the fields you may fill 
in, your options, default values; it 
also includes selected examples. 


Section 6, Using DSG/3000 Program- 
matically, serves as a general 
introduction to the use of procedures 
when DSG/3000 is run programmatically. 
Following an overview and summary of the 
procedures, the way in which they are 
used to produce and enhance the differ- 
ent graph types is covered. 


Section 7, Procedures--Reference 
Spectfications, contains formatting in- 
formation for calling procedures from 
different program languages, data type 
and communications area information, and 
an alphabetical coverage of the 
procedures, their parameters, and 
selected examples of their use in 
programs. 


Appendix A contains tables showing the 
available textures and colors as well as 
their order of use. Examples of 
programs written in COBOL, BASIC, SPL, 
PASCAL, and FORTRAN are included in Ap- 
pendix B. Appendix C contains a list 

of error messages. Maximum limits for 
interactive and programmatic use appear 
in Appendix D. Appendix E contains 
information regarding the use of figure 
files. Appendix F instructs the user 

in converting DSG/3000 files created 
using an earlier version. They may be 
updated interactively or programmati- 
cally. Appendix G contains detailed 
information on the plotters and ter- 
minals supported by DSG/3000. (Supported 
devices are listed at appropriate places 
throughout the manual.) 


Introduction to DSG/3000 


HP Decision Support Graphics/3000 is a 
data display system that allows you to 
design, produce, and save business 
graphs drawn from information kept in a 
data file. The graph can be displayed 
on a graphics terminal, or a permanent 
copy can be made on a plotter. The 
devices supported by DSG/3000 are listed 
later in this section. 


DSG can be used interactively through a 
series of screen menus, or program- 
matically through a set of procedures. 
Both the interactive user and the pro- 
grammatic user have access to the full 
capabilities of the product. 


HP Family of Graphics 


HP has been a major contributor to the 
field of technical graphics for years, 
producing top-quality printers, plot- 
ters, standalone graphics terminals, 
and desktop computers. Software has 
been developed which extends the use 
of graphics to business. Besides 
DSG/3000's extensive capabilities, HP 
offers the following graphing tools 

to its users: 


HPEASYCHART -- a chartmaker that allows 
a variety of office workers to produce 
high-quality graphs and charts in 

in minutes by filling out a few simple 
menus. It is ideal for one-time chart 
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making when it isn't necessary to access 
stored data. 


HPDRAW -- a visual aid design tool with 
which you can create simple figures 
using lines, boxes, arrows, and circles 
and save them for later use. You can 
also include charts developed by DSG/ 
3000 or HPEASYCHART on regular or flip- 
top sized paper or overhead transpar- 
encies. 


HP2680A GRAPHICS PACKAGE -- allows you 
to merge text and graphics on the 
HP2680A Laser Printing System, eliminat- 
ing tedious cutting and pasting in the 
production of manuals and reports,which 
you can print on demand -- at 45 pages 
per minute. 


Types of DSG/3000 Graphs 


DSG/3000 enables you to draw the follow- 
ing types of graphs: 


-pie charts 

~line charts 

-scattergrams 

-horizontal and vertical bar charts 
-slides consisting of simple annotations 


Some examples of graph types follow on 
the next few pages. 
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Figure 1-2. Line Graph 
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Figure 1-3. Pie Graph 
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Figure 1-4. Scattergram 
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Figure 1-5. Slide 
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Capabilities and Features 


The following are the main features of 
DSG/3000: 


o Data can be taken from any MPE file 
that is suitably formatted. 


o Data can be automatically scaled for 
you by DSG/3000. 


o Since chart design is independent of 
the data, data can be updated or modi- 
fied without changing the chart speci- 
fications. | 


o Arithmetic and special functions can 
be applied to your data and plotted. 


o Chart design is device independent. 


o Chart specifications can be stored for 
periodic use. 


o Graphs can be designed to be plotted 
in multiple colors when output is 
routed to a multi-color device. 


o A collection of charts can be drawn 
periodically in production mode. If a 
scrollable plotter is used, this 
process can be completely automated. 


o Graphs can be annotated with symbols 
and text. 


o Graphs drawn by DSG/3000 are acces- 
sible to other subsystems through the 
creation of figure files. 


Access 


DSG/3000 can be accessed interactively 
through the program GRAPH which gen- 
erates screen menus, or programmatically 
through procedures. 


Interactive Access 


The DSG/3000 interactive program, known 
as GRAPH, is designed for ease of use. 
Chart design is guided by screen menus 
presented in logical sequence with 
fields to be filled by the user. No 
special command language is needed, and 
a special HELP facility built into the 
system can be called upon for assistance 
when required. 


GRAPH also provides flexibility of 
design. Many options and enhancements 
are available to the user, but sensible 
defaults are provided so that you can 
produce high quality charts quickly and 
easily. At the user's option, GRAPH 
will dynamically alter specifications 
such as axis scaling and labeling to 
adapt to changes in the data. 


Programmatic Access 


User application programs can use 
DSG/3000 procedures to create, modify, 
and produce charts. This capability 
enables programs which periodically gen- 
erate reports to include graphs as a 
tool to clarify data, present a summary, 
or emphasize a point. 


Data and Chart Specifications 


In order to produce a graph, you must 
specify both the chart attributes and 
the data file. A chart contains the 
skeletal characteristics of a graph such 
as graph-type, title, legends, and an- 
notations. Several different charts can 


1-10 


be stored in a single chart file. 

A chart file is a graphics portfolio. 
The data file contains the actual 
values of the variables to be plotted, 
and is completely separate from the 
chart definition. 


DSG/3000 keeps the chart specifications 
separate from the data so that you can 
modify data values without making 
changes to the contents of the chart 
file. 


Periodic Use 


Once a chart has been designed and saved 
in a chart file, you may use the chart 
periodically with different or revised 
sources of data. An interactive option 
allows you to draw all of the charts in 
a chart file at the same time. 


Figure 
File 





user 
program 


Interactive CHART DESIGN DSG/3000 
Menus SPECIFICATIONS PROCEDURES 


resides in 


Menu 
VPLUS/3000 
User Program 

QUERY 
EDITOR 
TDP 


Graphics 
Plotter or 
Terminal 


SENS eee 


Figure 1-6. DSG/3000 Overview 
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Charts and Chart Files 


A user may create several different 
chart files, each containing charts that 
relate to one another or that are often 
drawn at the same time. You can access 
one chart file at a time; this is called 


CHART FILE 1 CHART FILE 2 





the current chart file. Within the 
current chart file, you can only add or 
modify one chart at a time; this is 
called the current chart. Figure 1-2 
illustrates the current chart and chart 
file. 


The file code for chart files is 1083. 


CHART FILE N 


CURRENT CHART 
FILE 


Figure 1-7. Current Chart File and Current Chart 


Accessing Other Subsystems 


Users of other subsystems such as 
HPDRAW, TDP/3000, and the 2680A (Laser 
Printer) can access graphs and slides 
produced and stored by DSG/3000 through 
the creation of figure files. Figure 
files provide long term storage for 
graphical information. They offer the 
following features: 


o a means of transporting device inde- 
pendent graphical information from one 
office systems application to another. 


o a method of storing a combination of 
chart and data information; if defini- 
tions later change, figure will not 
change. 


o an archival medium for storing 
graphical information. 


When you store a chart or slide ina 
figure file, you are effectively drawing 
it to the file. The information that 
will be stored in the file is complete 
and cannot be changed. Unlike the 
contents of chart files, which include 
only chart information, figure file con- 
tents include both data and chart 
information. 


DSG/3000 can create figures but not ma- 
nipulate them. Subsystems such as 
HPDRAW can place the figures built by 
DSG/3000 in a drawing and perform oper- 
ations such as scaling, rotating, and 
moving. Modification of data or chart 
must be undertaken before the image is 
stored in a figure file. Multiple fig- 
ures, each with a unique name, may be 
created. The contents of figure files 
can only be displayed by way of another 
subsystem. 


Data Sources 


The data file, containing the values of 

the data variables, is an MPE file con- 

taining ASCII data that can be generated 
by: 


-QUERY/3000 

-VPLUS/3000 

-EDIT/3000 

-TDP/3000 

-user report-generating programs 
-GRAPH data-entry screen 


DSG/3000 also allows you to create new 
data from original data values and plot 
the new, transformed values. The follow- 
ing types of transformations are 


provided: 


Arithmetic 
Operations 


Common 
Functions 


Special 
Functions 


Add, subtract, multiply, 
divide, modulo, and expo- 
nentiate 


Common log, natural log, 
square root, and absolute 
value 


Cumulate, moving average 


A Graphics Terminal Keyboard 


It is recommended that you run DSG/3000 
on a supported graphics terminal if pos- 
sible. These terminals produce the 
screen menus in standard alphanumeric 
mode and draw the graphs in graphics 
mode. If you are not using a graphics 
terminal see "Selecting a Device” in 
this section for information about non- 
graphics terminals and devices to which 
graphic output can be directed. 


Terminal Control Group 


Alphanumeric 
Keyboard 


— 


The keyboards of the 2647A and 268A 
graphics terminals are similar. Refer 
to Figure 1-8, showing the 2647A 
terminal keyboard, to locate some of the 
special keys used in GRAPH. (See the 
User's Manual that describes your 
terminal for complete instructions on 
terminal use.) The keyboard of the 2623A 
graphics keyboard is shown later in this 
section. 


Function Keys Edit Group 





Graphics Display 
Control Control 
Group Group 


2647A 


Figure 1-8. 2647A Graphics Terminal Keyboard 


Character Set Group 


Use the TAB key to go from one item 
(field) to the next in each screen menu. 
If you are using a 2647 or 2648, you can 
move the cursor backwards by holding 
down the CONTROL key (labeled CNTL) 
while you press the TAB key. If you are 
using a 2623A you hold down the SHIFT 
key and press TAB to move the cursor 
back. 


Graphics Control Group 


If you are using a 2647 or 2648 and you 
wish to turn the alphanumeric display on 
and off, hold down the SHIFT key and 
press the key front-labeled "A DSP”. 


To turn the graphics display on and off, 
hold down the SHIFT key and press the 
key front-labeled "G DSP". (You will 
not be able to test this effect until 
you enter some graphics into graphics 
memory. ) 


The 4 keys labeled with heavy pointers 
control the movement of the graphics 
cursor. Two keys can be pressed simul- 
taneously for diagonal motion. Use 
these keys when positioning annotations 
on the graphics terminal. 


If you are using a 2623A, you will find 
some inconsistencies with these groups. 
Check your user's manual for specific 
information about the terminal's 
operation. 


Edit Group 


Because GRAPH operates in block mode, 
you can key all of the information into 
a single menu before actually sending it 
to the computer. You can use the INSERT 
CHAR and DELETE CHAR keys to insert and 
delete characters if you wish. 


Display Control Group 


The Cursor Control Keys, marked with ar- 
rows, move the cursor around the screen 
menu. The NEXT PAGE and PREV PAGE keys 
can be used to go from one page to an- 
other for those HELP Roadmap menus that 
take up more than one page. 


The CLEAR DISPLAY key can be used to 
clear all of the information from the 
unprotected fields, starting with the 
cursor location. To clear all 
unprotected fields on the menu, press 
the Home Cursor key (), followed by 
the CLEAR DISPLAY key. 


Terminal Control Group 


To send information that you have 
entered in a menu to the computer, you 
must press the ENTER key. The computer 
has no knowledge of any changes you may 
have made on a screen until you actually 
enter it with this key, because GRAPH 
runs in block mode. 


The BREAK key and the RESET TERMINAL key 
should only be used under unusual cir- 
cumstances discussed in Section VI, 
Using DSG/3000 Interactively. 


Special Functions Group 


The keys labeled f1 through f8 have 
special functions assigned to them by 
GRAPH. When you enter the Help Facil- 
ity, these functions change. These 
functions are discussed in detail in 
Section VI and their purposes are 
described in association with individual 
menus in Section V. 

The use of special function keys in set- 
ting the HP-IB address is discussed 
der Raster Printers in this section. 
Figure 1-9 below is a photograph of the 
2623 keyboard with key groups high- 
lighted. Your terminal manuals will 
explain the functions of the various 
groups. 


Function 
Edit 

Control : 

Keys Function Keys Group 


5£8 a i aS , eo8 sel 
KEYS PARE PAGE ~ fs - one Cuan 





Graphics 
Character Set Group Control 


Group 


Figure 1-9. 2623A Graphics Terminal Keyboard 
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Supported Devices 


DSG/3000 supports, directly and indir- 
ectly, a number of terminals, plotters, 
and plotter/printers. Table 1-1 lists 
them, and notes how they are addressed. 
More information about addressing may be 
found under Selecting a Device below. 


Table 1-1. Supported Devices 


Terminal HP-IB Graphics 

Designator Interface Capability 
YES NOQ 

2382 Xx 

2622 X 

2623A X 

2624A/B 

2626A 

2641 

2642 

2645 

2647A Xx 

2648A X 


2703 


D4 PG Pd PG PG 


Pa Dt 


Laser Printer (2680A) 


The Laser Printing System is treated 
as a hardcopy graphics output device. 


(Table 1-1, continued) 


Plotter and Printer 
Designators 


2-pen 
7470 

(opt .001) 

(opt .002) 
4-pen 
7220A/S 
7221A/B/S 
9872A/B/S 
8-pen 
7220C/T 
7221C/T 
7580A 

(opt.001) 

(opt .002) 
7858 

(opt .001) 

(opt .002) 
9872C/T 


Thermal Plotter/ 


Printer 
7240A 
7245A/B 


Mini plotter 


7225A/B 
(176014) 
(176034) 
(17604A) 


Interface 
HP-IB RS-232 
Xx 
X 
K 
Xx 
Xx 
Xx 
4 
X 
xX 
».4 
x 
».4 
».4 
x 
x 
x 
x 


Printers such as the 7310A, 2631G, and 
9876, while not directly supported by 
DSG/3000, may be attached to a 2648, 
2647, or 2623 graphics terminal for 
hardcopy purposes. The integral printer 
of the 2623 may also be used for hard- 
copy production. 


Selecting a Device 


As stated previously, it is recommended 
that DSG/3000 be run on a supported 
graphics terminal. On these terminals, 
screen menus may be produced in a stan- 
dard alphanumeric mode and drawn in 
graphics mode. 


Alternatively, you can run DSG/3000 on a 
non-graphics terminal such as the 2626A, 
2382A, or 2645A. These terminals will 
produce all of the screen menus but can- 
not draw graphs. However, graphic out- 
put can be directed to a 7220, 7221, 
7225, or 7240. Also, these terminals do 
not support plotters requiring HP-IB 
interface. Table 1-2 lists valid ter- 
minal and plotter combinations of all 
those devices supported, directly or 
indirectly, by DSG/3000. 


Table 1-2. Valid Terminal and Plotter Combinations 








INTERFACE TERMINAL USED VALID PLOTTERS 
RS-232 2622 , 2623, 2624, 2626 7220, 7221,7240,7580 Opt.001 
(Eavesdrop 2641 , 2642, 2645 , 2647 7585 Opt.001,7225A (176044) 
Mode) 2648 , 2382, 2703 
RS-232 7220A/C/S/T,7240 ** 
(Stand-alone 7221A/B/C/S/T,7225A (17604A) 
mode ) 7225A (17063A),7470 Opt.001 
7580 Opt.001,7587 (Opt.001) 
HP-IB 2647 , 2648 7225A (17601A) ,7245A/B 


7580A Opt.002,7585 Opt.002 


**S=scrollable paper,4 pens;T=scrollable paper,8 pens; 
A=non-scrollable paper,4 pens;C=non-scrollable paper,8 pens 
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and 
utput 


Repositionin 
Redirecting 


If you are running GRAPH from a terminal 
and want to direct the output to a 
hard-copy device, you can connect any 
one of the HP-IB plotters directly to 
the terminal. HB-IB (Hewlett-Packard 
Interface Bus) devices must be used with 
an HP-IB board (13296A Shared Peripheral 
Interface) and a raster dump ROM to con- 
nect them to a terminal. The 2647A 
graphics terminal is installed with the 
raster dump ROM. Recent models of the 
2648A also include it. Older models of 
the 2648A with device support firmware 
designated HP1326A with Option 3 have 
it. Other older models may have the de- 
vice support firmware but not the raster 
dump ROM. In that case, it can be 
ordered as a separate part (P/N 
1818-0746), or with the shared 
peripheral interface, HP 13296A Option 
48, for the retrofit. 
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RS-232 devices are used between the com- 
puter and the terminal in the "eaves- 
drop" mode and/or directly connected to 
the computer in a stand-alone config- 
uration. All devices which may be used 
in eavesdrop mode may also be used 
standalone. In this case, the plotter is 
connected to a separate port, and 
graphic output is directed to it by is- 
suing the following file equation: 


>FILE GRAPHDEV; DEV=ldev 


where ldev is the logical device num- 
ber of the plotter. (The logical device 
number depends on the configuration of 
the system; your system manager should 
be able to supply you with this number.) 


In order to direct graphics to a plot- 
ter, specify the device and HP-IB 
address, if applicable, on the GRAPHING 
OPTIONS MENU (See Section V). This menu 
also allows you to position the graph on 
a page. 


For devices which are strictly HP-IB ad- 
dressable ( 9872A/B/C/S/T and 7245A/B), 
GRAPH will default to using HP-IB ad- 
dress 5. For devices which may be 
either HP-IB or RS232 addressable, such 
as the 7225A or 7580, a valid HP-IB ad- 
dress must be entered if desired. 
Otherwise, non-HP-IB addressing is as- 
sumed. 


Additional information concerning de- 
vices is provided throughout the manual 
as it pertains to specific operations of 
DSG/3000. 


Formal File Designators 


The following formal file designators 
are associated with DSG/3000: 


MENUDEV designates the device at 
that displays the menus 
(GRAF program only) 

GRAPHDEV designates the device at 


that draws the graphs 


$STDLIST is the default actual file 
designator for both MENUDEV and 
GRAPHDEV. In a session, $STDLIST is the 
log-on terminal. 


aree 


Raster Printers 


If you are running GRAPH on a supported 
HP graphics terminal, it is possible to 
transfer graphic output from the ter- 
minal to a raster printer such as the HP 
2631G or 7310A, using an HP-IB. The 
plotter HP-IB address should be set to 


° 


From the 2647A, use the following spe- 
cial function key commands: 


COMMAND 
fl 

fl 

£3 

f2 

fh 

fT 

6 
RETURN 


This is equivalent to the command: 


TRANSFER FILE FROM GRAPHICS TO HP-IB 6 


From the 2648A terminal, press the fol- If the graphics/numeric pad isn't set 


lowing function keys before logging on: for graphics operation, press the 
[SHIFT] key and [NUM] key 
GOLD simultaneously. 
INSERT 
CHAR Press: 
GREEN graph copy 
£5 
INSERT CHAR If you wish to copy a menu displayed on 
RETURN the screen, press the following: 
From the 2623A, you have a choice of AIDS 
using the integral printer or an exter- iat 8 


nal device. 
This takes you to device control. Next: 
To select the desired procedure, press 


the following in succession before log- home the cursor 

ging on: press the [copy all] key 
AIDS When you wish to print, press: 
fi 
£3 ESC 2p 


This displays the Device Control labels, 
and takes you to the “to devices’ selec- 
tion. 


Next, press one of the following: 


f3 (to integral printer) 
f2 (to external device) 


When you wish to print, press: 


ESC Q 


SECTION 2 


Graphing Terms 
and Concepts 
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Types of Data and Graphs 
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Purpose of Graphs 


The purpose of a graph is to display 
data visually. A single graph can dis- 
till hundreds of lines of data in a com- 
pact image. A graph is also an analyti- 
cal tool, allowing you readily to 
perceive and recall trends in the data, 
and to make quick approximations. 


The information on this page, presented 
in its tabulated form, would require 
considerable study in order for you to 
draw conclusions from it. 


MONTH QUOTA-SALES ACTUAL-SALES 
JAN 8680 7405 
FEB 8130 9356 
MAR 9620 8953 
APR 8009 6772 
MAY 9361 74uU0 
JUN 10153 9231 
JUL 9433 8139 
AUG 10231 10524 
SEP 9233 7882 
oct 9026 8261 
NOV 8657 7193 
DEC 10568 10730 


Using DSG/3000, you could plot 
QUOTA-SALES and ACTUAL-SALES against 
time in a graph, and the results would 
be readily apparent, as in Figure 2-1. 


The graph enables you to grasp the graph shows the relationship between the 


monthly fluctuations in each of the variables, each of which is represented 
variables. The maximum and minimum by a line. For example, you can quickly 
occurrences can be detected and approxi- spot those months in which actual sales 
mated at a glance. Furthermore, the met or exceeded quota. ‘ 


1979 SALES 


QUOTA— SALES ACTUAL— SALES 


DOLLARS 





Figure 2-1. Line Graph 
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Types of Data and Graphs 


DSG/3000 allows you to choose between 3 
basic types of graphs: lines (including 
scattergrams), bars, and pies. The 
graph type you choose depends on the 
nature of the data and the purpose of 
the graph. In order to understand the 
capabilities of different graph types, 
you need to understand some basic terms 
and concepts. 
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Independent and Dependent 
Variables 


For the graph given in Figure 2-1, MONTH 
is considered to be the independent 
variable because its changing value is 
governed independently from the rest of 
the data file. There can be only one 
independent variable per graph, and of- 
ten it is a time variable. The indepen- 
dent variable is plotted on the X-axis 
of a line graph or bar graph. 


On the other hand, SALES-QUOTA and 
SALES-ACTUAL take on values that change 
with time. They are considered depen- 
dent variables because they depend on 
the variable MONTH. Dependent variables 
are plotted along the Y-axis of a line 
graph. There is one line for each 
dependent variable. 


as clustered bars at each of the 12 data 


two dependent variables which are drawn 
points. 


LO 79 SALES. FIGURES 
NORTH AMERICA 


For 


dependent or Y-axis variable, stacked or 


clustered around each data point. 
example, the bar graph in Figure 2-2 has 


Bar graphs have one bar for each 
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Figure 2-2. 





Continuous and 
Discrete Data 


In Figures 2-1 and 2-2, there is exactly 
one data point for each month. The 
graph is drawn by plotting individual 
points. Then, if you are drawing a line 
chart, connecting lines are draw. If 
you are drawing a bar chart, bars are 


drawn up to the points. Note that, in bar 
graphs, you cannot easily estimate 

the value of sales at mid-month, for 
example. This data is considered to 

be discrete because each data point is 

a separate entity. Other common cases 

of discrete data occur when the inde- 
pendent variable uses text that does not 
represent time, as in Figure 2-3. 


MAJOR PUBLIC LIBRARIES 


‘ NUMBER OF BRANCHES 


Milwaukee 


Figure 2-3. 





BRANCHES 


Discrete Data 


In other cases, the nature of the data 
does allow you to read between data 
points. For example, suppose you 
graphed the total actual sales-to-date 
for the twelve months given previously. 
In this case, the data is continuous 


because it forms an uninterrupted series 
of points. Although there still may be 
only one data point for each month, the 
value of SALES-TO-DATE can be estimated 
or interpolated for dates between the 
data points. 


1979 CUMULATIVE SALES FIGURES 
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Figure 2-4. 





Continuous Data 


Choosing A Graph Type 


If you want to create a graph that shows 
how a variable changes over time, choose 
either a line or bar graph. Line graphs 
are best for showing trends in the data, 
especially when the values are 
continuous. 


Bar graphs always show data as discrete 
values. They are useful for showing 
relative weights of variables because 
the data values are represented by phy- 
sical blocks. Bar graphs are often used 
to show growth. 
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Showing Proportions 


If you want to show the relative dis- 
tribution of a variable, use a pie 
chart. While bar and line graphs in- 
volve at least two variables, pie charts 
graph one variable at a time as a per- 
cent of the total. 


A pie chart shows an entity broken down 
into its component parts. Each part is 
represented by a proportionate sector 
(slice) of the pie. For example, Figure 
2-5 shows the distribution of orders by 
product line: 


This pie chart gives a clear deter- 
mination of the products that had the 
greatest proportion of total sales. 


SALES ORDERS BY PRODUCT LINE 


SEDANS 


SPORTS COUPES 


PICK—UPS 


STEP—VANS 


PANEL TRUCKS 


(COMPANY CONFIDENTIAL) 


Figure 2-5. Pie Graph Showing Proportion 
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Showing Correlation 


If you want to show how variables in the 
data file correlate with one another, 
use a scattergram. You can think of a 
scattergram as a special type of line 
graph in which data point markers are 
plotted, but connecting lines are not 
drawn. Unlike a line graph, however, 
what is important in a scattergram is 
the clustering of data points rather 
than the direction taken from one point 
to another. 
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You can use a scattergram when you want 
to explore your data for possible rela- 
tionships between the variables, and 
when a simple functional relationship is 
not evident. Suppose that two of the 
variables in your data file are HEIGHT 
and WEIGHT. If there is an orderly 
relationship between these two 
variables, there will be a pattern to 
the distribution of points in the scat- 
tergram. For example, the graph in 
Figure 2-6 suggests a roughly linear 
relationship between the variables. 


After looking at the scattergram, you between the variables and predict its 
can try to approximate the relationship course. 


HEIGHT PLOTTED AGAINST WEIGHT 


WEIGHT 


2 WEIGHT IN POUNDS 





HEIGHT IN INCHES 





Figure 2-6. Scattergram Showing Correlation 
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Further Terms and Enhancements characteristics. The examples on the 

pages following illustrate several of 
Once you have chosen the type of graph the options and enhancements that 
that fits your needs, DSG/3000 allows DSG/3000 makes available for your use. 
you to specify many of the graph's 
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Figure 2-7. Line Graph 
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DSG/3000 provides eight different sym- sizes, called major and minor ticks 


bols for data markers, the points mark- respectively. 
ing the actual data values. There are 
also eight different line texture types If your data ranges over very wide- 
that are identified with legends. The spread values, it may be best to use 
scaling marks along the axes are called logarithmic scaling rather than linear 
ticks. They come in large and small scaling. The axes are scaled expo- 

. nentially. 
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Figure 2-8. Line Graph with Logarithmic Scaling 
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A scattergram is like a line graph with- 
out lines drawn between the data 
markers. 
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Figure 2-9. Scattergram 
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a legend 
Grid lines can 


> 


As in line charts 


identifies the texture. 


chart. 


Four enhanced bar charts are shown on 


the next few pages. 


make it easier to read the data values 
from the graph, as shown in Figure 2-10. 


There are eight different surface text- 
ures that can be used to draw a bar 
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Vertical Clustered Bar Graph 


Figure 2-10. 
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Figure 2-11. Vertical Stacked Bar Graph 


When the independent or X-axis variable on the left side of the graph and the 


is not time, it is preferable to draw dependent or Y-axis appears along the 
the bars horizontally, as illustrated in bottom of the graph, as though a 
Figure 2-12 and 2-13. In a horizontal vertical graph had been rotated 270 de- 
chart, the independent or X-axis appears grees. 
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Figure 2-12. Horizontal Clustered Bar Graph 
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Horizontal Stacked Bar Graph 


Figure 2-13. 
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You can draw attention to one or more it--that is, drawing it apart from the 
segments of a pie chart by exploding rest of the graph. 


SALES FORCE TIME MANAGEMENT STUDY 


DESK WORK 
32.0 % 
NEW ACCOUNTS 
5.0 % 
TRAVEL 
OPEN—DEBIT COLLECTIONS 12.0 % 


27.0 % 


OFFICE MEETINGS 
24.0 % 


(COMPANY CONFIDENTIAL) 


Figure 2-14. Pie Graph with Exploded Segment 
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SECTION 3 


Creating a Data File 


Interactive Data Entry 3-2 
Data File Format 3-2 
Filename and Security 3-4 
Data Entry Procedures 
and Examples 3-4 
Structuring the Data File 3-13 


Before you specify chart characteristics 
and draw the graph, you should decide 
how you want DSG/3000 to access your 
data. The six methods of creating a 
data file are summarized in Table 3-1. 


METHOD 


DATA PROMPT 
Screen Menu 


EDIT/3000 


TDP/3000 


QUERY/3000 


VPLUS/3000 


User Program 


DATA ENTRY 





Table 3-1. 


Interactive data entry 
and definition. User 
enters data on screen 
menu from within the 
GRAPH program. 


Data entered into an 
EDITOR file is used as 
a DSG/3000 data file. 


Data entered into a 
TDP file is used as a 
DSG/3000 data file. 


Repc« rts data values from 
an IMAGE data base to a 
data file or self-describing 
file. 


VPLUS/3000 batch file 
is accessed as a fixed- 
format data file. 


Periodic or report gener- 
ating program creates 
DSG/3000 data file. 


Since your data is kept in a file sepa- 
rate from the chart design specifica- 
tions, you can modify or add values to 
the variables in the data file without 
changing the chart design. 


DATA 
MODIFICATION 


Modify data directly on 
screen menu. 


Modify data using the 
EDITOR. 


Modify data using 
TDP. 


Modify data base using 
calls to IMAGE. Run 
QUERY to output new 
values. 


Run ENTRY program in 
BROWSE mode to modify 
data. 


Data is modified by the 
program. 





Summary of DSG/3000 Data Entry Methods 
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RESTRICTIONS 


Data file contains up 
to 5 variables; each 
variable can take up 
to 12 values. 


Must be formatted 
according to DSG/3000 
specifications. 


Must be formatted 
according to DSG/3000 
specifications. 


Data must reside in an 
IMAGE data base. Out- 
put file must be for- 
matted according to 
DSG/3000 specifications. 


Determine offset and 
length of each data field, 
using VPLUS/3000 formsfile. 


Output file must be 
formatted according to 
DSG/3000 specifications. 


interactive Data Entry 


If you are using DSG/3000 interactively 
and your data consists of a limited num- 
ber of variables and data values, the 
easiest method for entering the data is 
through the DATA PROMPT screen menu. 
When you use this method, DSG/3000 
builds the data file for you in the pro- 
per format and keeps a definition of the 
data internally. An illustration of 
this method is given below in Figure 


3-4. 


If you choose to use this method, it is 
not necessary to read the portions of 
this section on using other programs and 
subsystems to enter the data. You can 
refer to Figure 3-4, read the paragraphs 
on Structuring the Data File, and then 
proceed to Section IV, Using DSG/3000 
Interactively. 


Data File Format 


A DSG/3000 data file is an MPE file con- 
taining ASCII representation of data 
values. The maximum record length 
allowed is 512 bytes. The data values 
can be either numeric or textual, and 
numeric values can be signed (i.e., 


preceded by a + or -) or unsigned. The 


data file is restricted to a single re- 
cord type, which means that the ar- 
rangement of fields must be the same in 
all of the records. Each data variable 
can be associated with a particular 
field. A maximum of nine data variables 
from a data file may be used on any one 


graph. 


1.0E77 
1.0E-77 


Note: Maximum data value 
Minimum data value 


For example, Figure 3-1 is an example of 
a DSG/3000 data file with three fields. 


JANUARY. 
FEBRUARY 
MARCH 
APRIL 
MAY 

JUNE 


JULY 
AUGUST 
SEPTEMBER 
OCTOBER 
NOVEMBER 
DECEMBER 





Figure 3-1. DSG/3000 Data File 


The first field of this data file might 
be associated with the variable MONTH, 
the second field with SALES, and the 
third field with UNIT-PRICE. Note that 
the data file does not contain any 
labels to identify the fields, only data 
values. 


The data file can be in either free or 
fixed format. A free format data file 

is arranged in fields separated by com- 
mas or by any number of blanks. Any da- 
ta value containing embedded blanks must 
be enclosed in quotes so that the blank 
is not mistaken for a delimiter. 


Free format is a flexible format in that 
the fields do not have to be justified, 
although the variables must appear in 
the same order in every record. For any 
record, the first field starts with the 
first printable character and extends up 
to the first blank or comma; the second 
field starts with the next printable 
character and extends up to next blank 
or comma, and so forth. The data file 
in Figure 3-1 is in free format. Figure 
3-2 illustrates another way of free- 
formatting the same data. 


3-3 





~N 
= 
L 
JANUARY 987,68 
FEBRUARY, 088,64 
MARCH,1099,65 
APRIL, 1170, 58.8 
MAY,1160,57 


> > 
~ 
& 


JUNE,1199,46 

JULY, 1256,49.4 
AUGUST,1328,42 
SEPTEMBER,1301,42.2 
OCTOBER,1357,40 
NOVEMBER, 1387,35.2 
DECEMBER, 1422,33.4 


Figure 3-2. Free Format Data File 


In a fixed format file, a particular 
field must start in the same column and 
have the same length in every record. 
The offset of a data field is the num- 
ber of characters from the beginning of 
the record to the beginning of the data 
field. Although each field has a fixed 
beginning and end column, the placement 
of the data within each field is unre- 
stricted. 


Figure 3-3 shows the data file from 
Figure 3-1 in fixed format. The first 
field is 9 characters long with an off- 
set of 0; the second field is 4 
characters long with an offset of 9; and 
the third field is 4 characters long 
with an offset of 13. 








offset=0 


offset=9 
| ai offset=13 
JANUARY 987 68 
FEBRUARY 108864 
MARCH 109965 


APRIL 117058.8 


MAY 116057 


JUNE 119946 
JULY 125649.4 
AUGUST 132842 
SEPTEMBER 130142.2 
OCTOBER 135740 
NOVEMBER 138735.2 


DECEMBER 142233.4 





Figure 3-3. Fixed Format Data File 
Note that VPLUS/3000 generates 

fixed format MPE files. Therefore, if 
you have used VPLUS/3000 for data entry, 
the resulting batch file can be used as 
input to DSG/3000. 


You cannot mix free format and fixed 
format data in the same DSG/3000 data 
file. 
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Filename and Security 


Since the data file is an MPE file, 
standard MPE conventions are in effect 
for naming the file and establishing 
security. A filename consists of up to 
8 alphanumeric characters beginning with 
a letter, and an optional group and ac- 
count name. You can use passwords and 
lockwords to provide security, as do- 
cumented in the MPE Commands and Refer- 
ence Manual. 


Data Entry Procedures 
and Examples 


The six methods of entering data ina 
DSG/3000 data file are illustrated in 
the following examples: 


Method 1 -- DATA PROMPT Menu 


To use this method, you must run the 
GRAPH program interactively. After you 
enter GRAPH and choose to build a data 
file, the DATA PROMPT menu appears on 
the terminal. Note that this method 
allows for up to 5 variables taking up 
to 12 data values each. If you need to 
graph more than 5 variables or more than 
12 data values, you must use another 
method for data entry. 


Section IV, Using DSG/3000 
Interactively, gives the procedures for 
the two variables. MONTH is a textual entering the GRAPH program. Section V 
data variable (T); SALES is a numeric gives complete specifications for this 
data variable (N). The user then entered menu. 

all of the values of the two variables. 


In this example, the user filled in the 
filename DATA15 and information about 
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Figure 3-4. DATA PROMPT Example 


30 


Method II-- EDIT/3000 


Using the EDITOR to create a data file 
is an easy method. There are no re- 
strictions on the number of variables or 


-EDITOR 


data values, other than the restriction 
that only nine variables may be used on 
any single graph and record size may not 
exceed 512 bytes. 


HP32201A.7.10 EDIT/3000 WED, 
(C) HEWLETT-PACKARD CO. 


ADD/ 


On OOP WH — 


HOOnN PWN — OW 


/KEEP SRDATA, UNNUMBERED 
/EXIT 


PERRY 
DINKEL 
LUBISCH 
LOND 
COLASANTE 
NAKAMURA 
DOMINGUEZ 
TRAVIS 
KENNEDY 
GEBROE 
GEE 
BLUXOME 
ALENCAR 
SALOMON 
CRANE 

// 


END OF SUBSYSTEM 


Figure 3-5. 





1095 
1244 
1677 
1688 
1702 
1738 
1746 
1687 
1645 
1723 
1768 
1688 
1547 
1423 
1802 


EDITOR-Entered Data File 
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In Figure 3-5, the resulting data file 
contains two columns which represent two 
variables: NAME and TOTALSALES. Each of 
the variables takes 15 data values. 


The data file, SRDATA, was kept 
UNNUMBERED so that the line numbers 
would not be appended to the data re- 
cords. (If the file was kept numbered, 
the line numbers in columns 75 through 
80 would count as an additional data 
field.) 


Refer to the EDIT/3000 REFERENCE MAN- 
UAL for details about how to used the 
EDITOR. 


Method III -- TDP/3000-Entered Data File 


The TEXT AND DOCUMENT PROCESSOR, TDP, 
operates similarly to EDIT/3000 in many 
ways. The data file in Figure 3-5 could 
be created by TDP with few changes. In 
place of the command :EDITOR, you enter 
:RUN TDP.PUB.SYS to begin. A TDP banner 
will appear, and you can then ADD, TEXT, 
and KEEP UNNumbered your data file. 


Refer to the TEXT AND DOCUMENT 


PROCESSOR/3000 MANUAL MANUAL for de- 
tails about the use of TDP/3000. 
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Method IV -- QUERY/3000 


QUERY/3000 allows you to access a data 
base interactively. In order to create 
a data file for DSG/3000 using QUERY, 
follow these steps: 


1. Build the data file using the MPE 
BUILD command. The file must be a 
fixed length ASCII file with a 
record size of no more than 512 
bytes. (Since QUERY output files 
have longer record lengths by 
default, you must first build the 
file to specification.) For example: 


:BUILD FINANCE;REC=-80,, , ASCII 


In this example, the name of the 
data file is FINANCE, the record 
length is 80 bytes, and the records 
are ASCII coded. Disc files are 
fixed length by default. 


The BUILD command has other optional 
parameters. For complete 
specifications, see the MPE 
Commands Reference Manual. 


Equate QSLIST (QUERY output file) to 
the disc file built in step 1. For 
example: 


:>FILE QSLIST=FINANCE , OLD; DEV=DISC 


You must specify the keyword OLD 
because the system attempts to build 
a new file by default. 


Enter the QUERY subsystem. You can 
do this through the Command Inter- 
preter by issuing the command: 


:RUN QUERY. PUB.SYS 


Alternatively, you can run GRAPH. 
Then, by entering a Q on the MAIN 
CONTROL Menu, you can temporarily 
leave GRAPH, use QUERY to enter data 
into the data file, and automati- 
cally return to GRAPH after exiting 
QUERY . 


Define the QUERY environment by is- 
suing the >DEFINE command. In order 
to route QUERY output to the data 
file built in step 1, you must set 
OUTPUT equal to LP. Locate the en- 
tries that you want written to the 
data file by issuing the >FIND com- 
mand. (These commands might be kept 
in a QUERY XEQ file for 
convenience. ) 


3-8 


If you want all of the data items 
from the records located by the FIND 
command to be written to the data 
file, issue a >REPORT command 
including the following statements: 


A NOPAGE statement so that the first 
2 records of the file are non-empty. 


A Detail statement for each data 
item to be included in the data 
file, specifying the column offset 
for each item. 


Note that if the data base entries 
are longer than 512 bytes, you must 
use the REPORT command to select 
items totalling no more than that 
limit. The REPORT command state- 
ments can be kept in a QUERY/3000 
procedure file. 


Exit from QUERY. 


Figure 3-6 gives an example of using 
QUERY to create a data file. For more 
information, consult the QUERY Re- 
ference Manual. 


DSG/3000 accesses a data file built by 
QUERY as a fixed format file. You must 
indicate to DSG/3000 the length and off- 
set of each variable. This can be 
accomplished interactively using the 
DATA DEFINITION Menu (Section IV) or 
programmatically using the GDEFNSET 
procedure (Section VII). 


The data file created by Query in Figure 
3-6 contains three variables: DAY 
(beginning in column 1), QUOTA 
(beginning in column 6), and ACTUAL 
(beginning in column 17). 
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QUERY places a carriage control char- 
acter at the beginning of each line of 
data in the file. For DSG/3000 to pro- 
perly access the data, you should add a 
1 (one) to the value of each offset. 


Therefore, you should specify the off- 
sets and lengths for the three data var- 
iables as follows: 


Variable Offset Length 
DAYS 1 4 
QUOTA 6 10 
ACTUAL 17 10 


Note that the offsets are the same as 
the column numbers. 


RUN QUERY .PUB.SYS 


HP32216.B8.00.01 QUERY/3000 THU, JUN 3, 1982, 10:37 AM Run QUERY. 


QUERY/3000 READY 


>DEFINE Define the environment with output assigned to the 
DATA-BASE = >>GRAFDB terminal so that you read information about the 
PASSWORD = >> structure and content of the data base. 

MODE = >>] 
DATA-SETS = >>DATA 
PROC-FILE = >> 
OUTPUT = TERM 
OUTPUT = >> 


>FORM DATA The FORM command allows you to check the 


structure of the data base. 


DATA BASE: GRAFDB THU, JUN 3, 1982, 10:40 AM 


SET NAME : 
DATA, DETAIL 


ITEMS: . 
DAYS, <<SEARCH ITEM>> 


QUOTA, 
ACTUAL, 


CAPACITY: 124 ENTRIES: 19 


>FIND DAYS > 0 Find the data that you want in the data file. 


USING SERIAL READ 


19 ENTRIES QUALIFIED 
>SAVE SDFILE Through the SAVE command an MPE self-describing 


>EXIT file is built and the data retrieved through QUERY 
is kept in this file for later access by DSG. 


END OF PROGRAM 
:LISTF SDFILE. IMAGE .OPERATOR, 2 
ACCOUNT= OPERATOR OPERATOR= IMAGE 


FILENAME ----SPACE---- 
SIZE TYP EOF LIMIT R/B SECTORS #X MX 


SOFILE SO 24B FA 19 19 32 18 6 6 





Figure 3-6. Using QUERY to Build a Data File 
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Method V -- VPLUS/3000 


If you usually use VPLUS/3000 for data 


entry, your data is kept as a VPLUS/3000 


batch file. DSG/3000 can access this 
batch file as a fixed format file. You 
must indicate the length and offset of 
each variable to DSG/3000. This is done 
interactively in the DATA DEFINITION 
screen menu (Section V) of GRAPH or pro- 
grammatically in the GDEFNSET procedure 
(Section VII). 


You can determine the length and offset 
of the variables from the VPLUS/3000 
formsfile, which lists the variables in 
the order in which they appear in a data 
record with their corresponding lengths. 
By adding up the lengths of all the pre- 
ceding variable fields in the record, 
you can determine the offset of any gi- 
ven variable. 


See the VPLUS/3000 Reference Manual 

for further information about VPLUS/3000 
and using REFORMAT to subset multi-form 
batch files. 


Sige 


Figure 3-7 shows an example formsfile 
which could be used to collect three 
variables named MONTH, SALESACTUAL, and 
SALES-TARGET. After running 
ENTRY.PUB.SYS, a batch file could be 
produced with the following format: 


offset = 0 offset = 2 offset = 14 
| eae eeeeipatinn 1280-3344 1200 
2 1390 1300 
3 1700 1450 
4 1800 1750 
5 2000 1950 
6 1860 2000 
7 1731 1850 
8 1920 1850 
9 1100 1960 

10 1200 1300 

11 1500 1400 

12 1701 1500 


ee ee | 
length=2 length=12 length=12 


Note that blank spaces have been added. 





TerTCrrrecrrrreererereeeeeeeeereereeeceeeeeeeeeeeseseSe LSS Se eee SES SESS 222 eel ele! 


FORMSPEC Version B.02.04 
THU, JUN 3, 1982, 10:28 AM 


MAINTEST. PUB .MARTIN 
* 


OO OOOO ORI IOI III ROTOR I IOI I ROR IORI IOI TOR IOI IOFFICE FOIO TOK RK IKK 


Forms File Status - 
Modified: THU, JUN 3, 1982, 10:28 AM 
Compiled: THU, JUN 3, 1982, 10:28 AM 
Requires 470 + 60 = 530 words {add 500 for KSAMless fast forms file, or 
add 1300 for KSAMless slow forms file) 


* 
* 
* 
x 
x 
* 
x 


Head Form: 

Default Display Enhancement: HI 
Error Enhancement: IU 

Window Display Line: 24 

Window Enhancement: HI 


THERE ARE NO SAVE FIELDS IN THIS FORMS FILE. 


There are l forms in this forms file: 


aioe Fields pan Lines Next Form 


Form 
V_EXAMPLE S$HEAD 


FORMSPEC VERSION B.02.04 
FORMS FILE: MAINTEST.PUB.MARTIN 


Form: V_EXAMPLE 
Repeat Option: N 


THU, JUN 3, 1982, 10:28 AM 
PAGE 2 


Next Form Option: C 
Next Form: SHEAD 
Reproduced from: 


KOO ORO IOI ROI OOOO ROO IORI OOO IO KOK KR RAR 


MONTH: [MN] <ENTER 1 - 12 > 


Actual Sales: {asales ] 
Target Sales: [tsales 


KIO KOKI OO KOI IOI ROI KIT RR RR RO IKI RRR RK KKK RIK RRR RK RE KKK 


Field: MN 
Num: 1 Len: 2 ; Enh: HI FType: O DType: CHAR 
Init Value: 


Field: asales 
Num: 2 Len: 12 : ASALES Enh: HI FType: O DType: CHAR 
Init Value: 


Field: tsales 
Num: 3 Len: : TSALES Enh: HI FType: O DType: CHAR 
Init Value: 


Figure 3-7. VPLUS/3000 Example 
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Method VI -- User Program 


Any properly formatted file generated by 
a user program can be used as a DSG/3000 
data file. For example, if you have a 
program that generates reports periodi- 
cally, you can output data to an MPE 
file in free or fixed format. You can 
then designate this file as your 
DSG/3000 data file. If you wish to in- 
clude graphic displays with your re- 
ports, you can call DSG/3000 procedures 
from your report generating program to 
access the data file and draw the graph. 


Structuring the Data File 


DSG/3000 provides several optional fea- 
tures which allow you control over the 
variables and data to be plotted. These 
features include: 


o Qualification of variables 

o Data subsetting 

o Transformation of data values 
o Specification of missing data 


These features are discussed below so 
that you will be aware of them as capa- 
bilities when you create your data file. 
The actual specifying procedures are 
discussed for interactive users in Sec- 
tion IV and for programmatic users in 
Section V. 
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Data Manipulation Order 


In the data manipulation order below, 
steps 2 through 6 are optional. 


1. Raw data is converted to an internal 
DSG file. 

2. A sort is performed if you have 
transformations. 

3. Transformations are done. 

4. Subsetting is done. 

5. A sort is done by independent 
variable (if no transformations are 
being performed). 

6. Qualifications are done. 

7. Graphing is done. 


Note that only one sort is performed for 
a line or pie chart, pie charts at the 
user's option. Bar charts and scat- 
tergrams are not sorted. 


Data Qualifications 


There is often more than one way of con- 
structing a data file to produce a part- 
icular graph. Your data may have been 
stored and retrieved in such a way that 
a single data field contains information 
about more than one graphable entity. 
DSG/3000 allows you to qualify the 

data in a field so that the individual 
dependent or Y axis variables are 
uniquely identified. 


For example, suppose you want to draw a 
four-line graph with each line repre- 
senting the number of employees in a 
particular company plotted against time. 
The data file in Figure 3-8 has only 
three data fields: COMPANY, 
NUM-EMPLOYEES, and TIME. 


Acme 
Acme 
Acme 
Bayside 
Bayside 
Bayside 


Calco 
Calco 
Calco 
Dunwit 
Dunwit 
Dunwit 





Figure 3-8. Data File to be Qualified 
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The actual graph (shown in Figure 3-9) 
has four dependent variables (number of 
employees in Acme, Bayside, Calco, and 
Dunwit) plotted against time, but their 
values all appear in the second data 
field. You must qualify the variable 
NUM-EMPLOYEES using the variable COMPANY 
to create the following 4 subsets: 
VARTABLE QUALIFIER 
NUM-EMPLOYEES 
NUM-EMPLOYEES 
NUM-EMPLOYEES 
NUM-EMPLOYEES 


COMPANY =Acme 
COMPANY=Bayside 
COMPANY=Calco 
COMPANY =Dunwit 


Qualifiers are described by expressions 
using the relational and logical opera- 
tors listed in Table 3-2. You can 
qualify data variables interactively 

in the QUALIFICATIONS Screen Menu (Sec- 
tion V) or programmatically in the 
GDEPVARSET procedure (Section VII). 


Table 3-2. Data Qualifying and 
Subsetting Operators 

















Relational Equals 
Operators Not equal 
Greater than 
Greater than or equal to 
Less than 
Less than or equal to 
Logical Condition not true 
Operators 


Both conditions true 


At least one condition true 


The relational operators are performed 
in the order they appear from left to 
right and have precedence over logical 


operators. Logical operations are per- 
formed in the following order: 


1. NOT 
2. AND 
OR 
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This means that NOT operations are per- 
formed first, and OR operations are per- 
formed last. This order may be over- 
ridden by expressions in parentheses, 
whose operations are performed before 
all others. 


Examples of Qualifying Expressions 


COMPANY="Acme Corp." AND YEAR<1975 
SEX=M OR SALARY<20000 
MEMPLOYEES >FEMPLOYEES 


In these examples, COMPANY, YEAR, SEX, 
SALARY, FEMPLOYEES, and MEMPLOYEES are 
variable names associated with fields in 
the data file. Quotation marks are re- 
quired when the character string con- 
tains embedded blanks. Either single 
quote marks (apostrophes) or double 
quotation marks are allowed. 


Note: When data is qualified, the data 
that does not meet the qualifications is 
treated as missing data. Therefore, you 
may get unexpected results if the in- 
dependent X-axis variable is textual. 
This will not occur when the independent 
X-axis variable is numeric. (Textual 
variables are always treated as unique 
where numeric variables are not unique, 
and the matching numbers align them- 
selves appropriately.) Missing data is 
discussed later in this section. 


NUMBER OF EMPLOYEES 


BAYSIDE 


5 EMPLOYEE COUNT 





Figure 3-9. Example Graph 
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Data Subsetting 


The data file that you create may con- 
tain more information than you want to 
include in any one graph. DSG/3000 al- 
lows you to select a subset of the 
data file for inclusion in the par- 
ticular chart that you are designing. 
This means that you can make several 
graphs from different subsets of the 
same data file. 


Subsets are described by expressions 
using the same relational and logical 
operators listed in Table 3-2. While 
qualifications allow each data variable 
to have restrictions placed on it, 
subsetting restricts all variables to be 
graphed. 


data file 


Sales Rep 
Sales Rep 


Sales Rep 
Sales Rep 
Sales Rep 
Manager 


1 
2 
3 
4 
2 
6 
5 
5 


Engineer ——> 
Engineer (subset) 





You can subset a data file by the value 
of any data field, not just by the 
values of the data fields that are being 
graphed. For example, the data file in 
Figure 3-10 has three data fields asso- 
ciated with the variables SALARY, EXPER- 
IENCE, and POSITION. You could make a 
single-line graph of SALARY plotted 
against EXPERIENCE for all sales rep- 
resentatives by subsetting the data file 
with the expression: 


POSITION="Sales Rep" 


data plotted 


Sales 
Sales 
Sales 
Sales 
Sales 


Figure 3-10. Subsetting a Data File 


Data Transformations 


Instead of plotting the raw data as it 
exists in the data file, you may prefer 
to create new data by mathematically 
transforming the existing data and plot- 
ting the resulting values. You can name 
new variables and define them as mathe- 
matical functions of the old variables 
using expressions in Table 3-3. 

DSG/3000 will perform the necessary cal- 
culations without changing the original 
data values. You can then reference the 
new variables as if they were fields in 
your data file even though the data file 
has not been altered. 


You can specify data transformations 

interactively in the DATA TRANSFORMA- 
TIONS Screen Menu (Section IV) of 

of GRAPH, or programmatically in the 

GTRANSET procedure (Section V). 


Table 3-3. 
Arithmetic + 
Operators 7 
/ 
MOD 
Common LOG (exp) 
Functions LN (exp) 
ABS (exp) 
SORT (exp) 
Special CUMULATE (var) 


Functions 


Data Transformations 


Add 

Subtract 

Multiply 

Divide 

Exponentiate 

Modulo (divide and save 
remainder) 


Common (base-10) logarithm 
Natural (base-e) logarithm 
Absolute value 

Square root 


Cumulation 


MOVEAVG (var,n) Moving average 


where “‘var” is a variable, “exp” is an expression, and ‘’n” is an 


integer. 


Order of Precedence: 1. 


** common and special functions 


2. *,/,MOD 


3. +,- 


Parentheses can be used to override the standard order of 


precedence. 


Note: CUMULATE and MOVEAVG cannot be 


nested. 
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The common functions operate on mathe- 
matical expressions of data variables 
and arithmetic operators. For example, 
in the following transformation: 


BACKLOG=ORDERS -SHIPMENTS 


ORDERS and SHIPMENTS are previously de- 
fined variables. 


Common functions can also be compounded 
to form a new variable, such as: 


ROOT=SQRT (ABS (A+B) ) 


where the variables A and B are added, 
the absolute value taken and the square 
root extracted to define the new var- 
iable ROOT. Functions can also be used 
themselves within expressions. For ex- 
ample: 


G=20*LOG(P) 


The transformations are processed in the 
order they are specified. The names as- 
sociated with transformations may not 
match the names of variables in the data 
file. Therefore, transformed variables 
can be used within subsequent trans- 
formation statements, as this example 
illustrates: 


FNUMBER=FNUM/1000 MNUMBER=MNUM/1000 
TOTAL=FNUMBER+MNUMBER 
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NOTE: If data cannot be transformed or 
has illegal results, the missing data 
value will be substituted as the result 
of the equation. 


The special cumulative function provides 
a running total of numeric data for a 
given variable. For example, if your 
data file contains TIME and SALES, and 
if you requested the following trans- 
formation: 


SUM=CUMULATE (SALES ) 


the data file could be regarded as con- 
taining the following information: 


TIME SALES SUM 

1970 27658 27658 
1971 24115 51773 
1972 28224 79997 
1973 36543 116540 
1974 43428 159968 


The special moving average function pro- 
vides a running average for a given var- 
liable. The average is taken over the 
previous n values, as specified by the 
user. If no previous values are pre- 
sent, they are not averaged. For 
example, if your data file contains TIME 
and SALES, and if you requested the fol- 
lowing transformation: 


AVG = MOVEAVG(SALES ,3) 


The data file could be regarded as con- 
taining the following information: 


TIME SALES AVG 
1970 10000 10000 
1971 15000 12500 
1972 17000 14000 
1973 21000 17666.7 
1974 15500 17833.3 

Missing Data 


Some of the values of your variables may 
not be available to you at the time you 
create your data file. For example, a 
file that contains MONTH, SALES-QUOTA 
and SALES-ACTUAL may be created when all 
of the values for the first two var- 
jables are known, but the SALES-ACTUAL 
values are entered month by month. The 
values that are not present at the time 
you generate a graph are called mssing 
data. If you designate data as missing, 
DSG/3000 will ignore it when plotting 
the graph. Any blank values in the data 
file are treated as missing data. 
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When you create the data file, choose a 
numeric value to enter wherever there 
are missing data values. You then spe- 
cify this missing data value to DSG/3000 
interactively in the DATA DEFINITION 
Screen Menu (Section IV), or pro- 
grammatically through the GDATAFILESET 
procedure. 


For the data file in Figure 3-11 with 
variables representing TIME, 
SALES-QUOTA, and SALES-ACTUAL, the en- 
tries with value -9999 are designated as 
missing data. A warning will be returned 
by DSG/3000 when the chart is drawn to 
let you know that some fields contain 
the missing data value. This warning 
may also be produced by using qual- 
ifications or transformations. 


Any time a calculation is performed on 
missing data, its value becomes missing 
data except in the cases of CUMULATE and 
MOVEAVG. When the special function CUM- 
ULATE is being performed, the current 
value is substituted for the data point. 


Also, when line charts are drawn, the Note that a missing data variable can 


pen continues from the present point to only refer to numeric variables. A 

the next present point. It does not blank column is also treated as a mis- 
lift for a missing value unless the sing data variable for fixed format. 
value occurs at the beginning or end of 

a line. This also applies to the end-of-line for 


free format files. In free format, com- 
mas must be used as delimiters when mis- 
sing data occurs between columns of 
other variables. 





Figure 3-11. File with Missing Data 
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Figure 3-12. Line Graph with Missing Data Values 
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Running DSG/ 3000 Interactively 


DSG/3000 may be run interactively by us- 
ing the program called GRAPH or program- 
matically using the procedures discussed 
in Section VII. This section presents 
general information about interactive 
use. Section V discusses individual 
menus in detail. 


After you log on and run GRAPH.PUB.SYS, 
a series of formatted screens, called 
menus, will appear on your terminal. 

You design charts by simply filling out 
the menus. Each of the menus is comple- 
mented by the explanatory HELP facility, 
which appears on your terminal at the 
touch of a function key. 


Special Function Keys 


The keys labeled fl through f8 have spe- 
cial functions assigned to them by 
GRAPH. If you enter the GRAPH Help Fa- 
cility by pressing the last function key 
(f8), some of the keys are re-assigned 
to have different functions. 
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The function keys are displayed and 
labeled at the bottom of each screen 
menu. Any keys that are unlabeled are 
inactive for that screen menu. It is 
not necessary to memorize the function 
keys at any time. 


Running GRAPH 


To enter GRAPH, simply log on and type: 
:RUN GRAPH.PUB.SYS 


After you press the carriage return, the 
Main Control Menu will appear on your 
terminal. In this and each succeeding 
menu, fill in the fields that appear in 
inverse video (black letters on a white 
field). Information can be entered only 
in these areas of the screen, called 
unprotected fields, since the rest of 
the screen is ‘protected against any 
modification. The cursor will automati- 
cally move to the next unprotected field 
when you reach the end of the present 
field or if you press the TAB key. 


To use DS to access GRAPH on another 
system, the DSLINE command must be is- 
sued as follows. 


:DSLINE dsdevice;LINEBUF=4048 


where dsdevice is the name assigned to 
the remote computer. 


When using a modem to access a remote 
computer, you must specify the terminal 
type to be 10 on the HELLO command as 
follows: 


:HELLO user.acct;TERM=10 
Block Mode 


Whenever you enter or change information 
on a menu, you must press the ENTER key 
to send the information to the computer. 
This is because GRAPH operates in block 
mode, in which the ENTER key performs a 
function similar to that of the RETURN 
key in character mode. (In block 

mode, the RETURN key does nothing other 
than position the cursor at the begin- 
ning of each line.) 


If you wish to go on to another menu 
without making changes to the current 
menu, it is more efficient to press the 
DONE, PREVIOUS, or NEXT keys where 
applicable than to press ENTER. This 
avoids retransmitting information to the 
computer. 


Message Window 


The top line of each menu displays the 
title of the menu and, in some cases, 
the name of the current chart. GRAPH 
uses this “window to return messages to 
you when it is performing certain func- 
tions or when it detects an error. 


Correcting Errors 


If you notice an error anywhere on a 
screen menu, you can correct it by posi- 
tioning the cursor under the character 
you want to correct, using any of the 
terminal keys described in Section I. 
After you correct the mistake, press EN- 
TER to send the corrected information to 
the computer. 


Some errors are detected by GRAPH when 
you press ENTER. If GRAPH detects any 
errors, it returns a message in the mes- 
sage window as described above. This 
message provides the information you 
need to correct the error. You can then 
press ENTER. If you need more informa- 
tion about the menu, press HELP (f8), or 
refer to Appendix C. 


Break Key 


If you accidentally press the BREAK key 
while running GRAPH, you can recover by 
performing the following steps: 


1. Press RESET TERMINAL twice. 


2. Press RETURN to get the MPE colon 
prompt. 


3. To turn the echo on, press the Escape 
(ESC) key and then the Colon (:) key 
(optional to see what you are 
typing). 


4. Type RESUME and press RETURN. The 
message READ PENDING is displayed on 
the screen. On 262X terminals, in 
order to display the user keys, you 
must first press 


USER 
KEYS 
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5. Press REFRESH (function key f4) to 
display the current menu. 


A power failure will simply interrupt 
execution of your program, but a full 
system failure will log you off the sys- 
tem. After a power failure, you can re- 
sume execution using the steps outlined 
above. If the system had failed when 
you attempted to resume in this manner, 
a system message would have prompted you 
to log on when you typed RESUME. 


Terminating Plotting 


If you find it necessary to terminate 
plotting while the plotter is operating, 
use <Control Y> to do so; turning off 
the plotter itself halts communication 
between the system or terminal and the 
plotter. <Control Y> operates when you 
press the Y key while holding down the 
CNIL key. The Y key may have to be 
pressed several times before control re- 
turns because of storage areas within 
the plotter itself. Recovery is the 
same as from Break, described on this 


page. 


Terminating GRAPH 


You can terminate a GRAPH session by re- 
turning to either the Main Control Menu 
or the Chart Design Control Menu (press 
the special function key labeled DONE) 
and entering an "E" for EXIT. The END 
OF PROGRAM message and colon prompt (:) 
indicate that you have been returned to 
the control of the operating system in 
character mode. 


Using Menus 


GRAPH menus are self-explanatory to the 
experienced user; for those less 

familiar,the HELP screens provide neces- 
sary information relative to the menu on 
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your screen. Table 4-2 below sum- 
marizes the purpose of each menu. In 
Section V each menu is discussed in de- 
tail, including the possible entries for 
each field, examples of legal entries, 
defaults, and the particular use of 
function keys relative to individual 
menus. 


It is not necessary to memorize the 
functions of the menus. The information 
included here is a guide which may prove 
helpful in following the chart design 
information that concludes this section. 


Table 4-2. Summary of Screen Menus 





MENU 


FUNCTION 


ue 


Main Control 


Chart Design 


Control 


Data Prompt 


Data Definition 


Data 


Transformations 


Pie Chart 


Line Chart 


Bar Chart 


Qualifications 


Names and creates the current chart and 
chart file; selects the graphing function or 
utility to be performed. Also allows you to 
enter the QUERY subsystem or access figure 
files. 


Branches to any one of the design menus 
used to specify or modify chart attributes. 


Constructs or modifies a GRAPH data file for 
input to DSG/3000. 


Specifies the name of the data file; names 
and locates the variables within the data 
file. Optionally specifies a missing data 
value. 


Creates new variables by mathematically 
transforming the original data variables. 


Specifies variables, design options, data 
subsetting and explosions for a pie chart. 


Specifies variables and data subsets for line 
charts and scattergrams. 


Specifies variables, data subsets, and design 
options for bar charts. 


Qualifies data variables from the data file. 
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Table 4-2 (Continued) 





MENU 


FUNCTION 





Font Definition 


Pie Chart Labels 
Label Prompt 
Line Chart 


Legends 


Bar Chart 
Legends 


Bar and Line 
Chart Titles 


Pie Chart Titles 


Line Chart Axes 


Bar Chart Axes 
Numeric) 


Allows users to map fonts and native languages 
to the four font numbers which are active 
when a chart is being designed. 


Specifies color, texture, and labels for each 
segment of a pie chart. 


Specifies a label for each bar in a bar chart 
or for each tick in a line chart. 


Specifies color, texture, markers, and legend 
for each Y-axis variable in a line graph. 


Specifies color, texture, and legend for each 
Y-axis variable in a bar chart. 


Specifies titles, subtitles, footnotes, and 
axes titles for line and bar charts. 


Specifies titles, subtitles, and footnotes for 
pie charts. 


Specifies axis type, scaling, ticks, grids, and 
tick labels for both axes of a line chart. 


Specifies axis type, scaling, ticks, grids, tick 
and bar labels, and number of bars for both 

axes of a bar chart with a numeric independent 
variable. 


Table 4-2 (Continued) 


MENU 


FUNCTION 





Bar Chart Axes 
Textual) 


Bar and Line 
Text Control 


Pie Text Control 


Annotations 


Figure File 


Graphing Options 


Chart 
Information 


Chart Browse 


Specifies axis type, scaling, ticks, grids, tick 
and bar labels, and number of bars for both 

axes of a bar chart with a textual independent 
variable. 


Specifies color, size, and font for text 
on a bar or line chart, including titles, 
subtitles, axis labels, legend labels, and 
footnotes. 


Specifies color, size, and font for text on a 
pie chart, including titles, subtitles, labels 
and footnotes. 


Adds or deletes annotations: arrows, lines, 
boxes, or text. Fully specifies type and 
placement of each annotation. 


Adds or deletes figures (data and chart design) 
in a figure file for access by other subsystems. 


Specifies plotting device and address, speed, 
number of copies, size, and suppression of 
individual components. 


Returns information about the current chart 
such as creator, date of creation, and chart 
type. Allows you to enter comments about 
the chart that are returned by both the 
Chart Information and Browse Menus. 


Returns names and comments about all charts in the 
current chart file and chart type. 
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Control Menus 


The MAIN CONTROL MENU gives an overview 
of the system. The operations that you 
can perform using GRAPH can be grouped 
into two areas: chart file utilities and 
chart design. All of the chart file 
utilities can be performed from the MAIN 
CONTROL Menu. Chart design, which 
includes creating a new chart or mod- 
ifying an existing chart, is managed 
through the CHART DESIGN CONTROL Menu. 
Entering an A or M (for Add or Modify a 
chart) on the Main Control Menu trans- 
fers you to the Chart Design Menu. 


MAIN CONTROL MENU 


draw chart 

copy chart 

Barge chart 
get chart info 


browse chart file 
CHART 
DESIGN 
CONTROL 
MENU 


figure file 


specify chart type 

build data file enhance chart 

define data annotate chart 

transform data specify graphics device 
text control 


font definition 





Functional Overview of GRAPH 
Control Menus 


Figure 4-1. 


4-8 


Defaults 


Some of the items in the above menus 
have defaults assigned to them by GRAPH. 
In these cases, the default is already 
filled in for you when the menu appears 
on your screen. In order to override 
the default, you only need to type over 
the given values and press ENTER. For 
example, the CHART DESIGN CONTROL Menu 
comes up on your screen with and S for 
"Slide" as the default chart type. When 
you are specifying the chart type, you 
can type the appropriate letter over the 
S. 


All of the defaults are documented in 
the screen menu references in Section V. 


DATA PROMPT 
1 


DATA 
DEFINITION 
DATA 
TRANSFORMATIONS 
CHART DESIGN 
CONTROL MENU 


what chart 
type? 


BAR LINE 
CHART 
PIE CHART QUALIFICATIONS 
LABELS 


PIE CHART BAR CHART AXES LINE CHART 
TITLES (NUMERIC OR AXES 
TEXTUAL) 


BAR CHART LINE CHART 
LEGENDS LEGENDS 
BAR AND LINE CHART 

TITLES 

GRAPHING 
OPTIONS 

BAR AND LINE CHART PIE TEXT 

TEXT CONTROL CONTROL 
FONT 

DEFINITON 


Figure 4-2. Menu Loops Controlled by NEXT Function Key 
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Moving from Menu to Menu 


There is usually more than one path that 
you can take to get from your current 
screen menu to any other menu. Pressing 
DONE (f7) always brings you back to the 
CHART DESIGN CONTROL Menu or MAIN CON- 
TROL Menu, from which you can reach al- 
most any other menu by entering a letter 
designation. Alternatively, pressing 
NEXT (f6) brings you through a loop of 
menus that are logically linked to- 
gether. You can go backwards through 
the loop by pressing PREVIOUS (f5). At 
the end of the loop you are returned to 
a Control Menu. 


You can use NEXT efficiently as long as 
you need to enter information on 
subsequent menus. In general, you would 
use a combination of DONE and NEXT to 
quickly step through the menus needed to 
design a chart. 


Figures 4-3, 4-7, and 4-9 illustrate how 
the menus are linked through the Control 
Menus for designing Pie Charts, Line 
Charts, and Bar Charts, respectively. 
Figure 4-2 above shows how the menus are 
linked by NEXT and PREVIOUS loops. 
Pressing NEXT brings you through the 
previous menus in the direction of the 
arrows, and pressing PREVIOUS brings you 
in the opposite direction. 
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There are four basic loops: 


Data Loop 

. Pie Chart Loop 
Line Chart Loop 
- Bar Chart Loop 


FWwWN 


Note that from the CHART DESIGN CONTROL 
Menu, you cannot use the NEXT key be- 
cause the menu sequence depends on the 
type of chart you are designing. Other- 
wise, pressing the NEXT key allows you 
to step through a whole sequence of 
menus used to design a chart. 


Steps in Chart Design 


The following pages are intended to re- 
late menus to the steps necessary in de- 
signing a typical chart -- in this in- 
stance, a pie chart. The basic chart is 
designed, enhancements are added, and 
then it can be modified. The chart is 
drawn at each stage. Less detailed in- 
formation on line chart and bar chart 
design and enhancements follow. 


In order to design a complete chart, you 
must perform the following steps: 


1. Name the chart and the chart file in 
which it will reside. (MAIN CONTROL 
Menu) 


2. If a suitable MPE data file does not 
already exist, build a data file. 
(DATA PROMPT Menu) 


3. Name the data file; if it was not 
built from the Data Prompt Menu, 
describe its structure. (DATA 
DEFINITION Menu) 


4. Specify the chart type. (CHART DE- 
SIGN CONTROL Menu) 


5. Select the variables to be plotted. 
(PIE/BAR/LINE CHART Menus) 


After filling in these menus you can 
draw the chart. You can also add some or 
all of the following features: 


6. Create mathematical data 
transformations. (DATA 


TRANSFORMATIONS Menu) 


7. Qualify the data variables. 
(QUALIFICATIONS Menu) 
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8. Select a subset of the data to be 
graphed. (PIE/LINE/BAR CHART Menus) 


9. Enhance the chart. (TITLES, 
LEGENDS, LINE/BAR AXES, PIE LABELS, 
LABEL PROMPT, TEXT CONTROL, FONT 
DEFINITION Menus) 


10. Annotate the chart. (ANNOTATIONS 
Menu) 


11. Redirect output to plotter. 
(GRAPHING OPTIONS Menu) 


To modify a chart, perform the following 
steps: 


12. Inform GRAPH of the menu you wish to 
modify. (MAIN CONTROL Menu) 


13. Instruct GRAPH concerning the type 
of information you wish to modify. 
(CHART DESIGN CONTROL Menu) 


14. Modify chart by typing directly over 
information you desire to change. 


Note: All of the data file concepts 
(format, transformations, subsets, qual- 
ifications, etc.) are discussed in Sec- 
tion III. The menu specifications are 
explained in detail in Section V. 


Creating the Basic Pie Chart 


MEt 
TCIFD] Gf A} L] Ti 


- DATA 
TRANSFORMATIONS 


PIE CHART 

TITLES 

PIE CHART 
LABELS 
ANNOTATIONS 

GRAPHING 

OPTIONS 

FONT 
DEFINITION 


PIE TEXT 
CONTROL 


Figure 4-3. Pie Chart Road Map (required menus are shaded) 
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Figure 4-4 shows the routing of the 
menus used in designing a Pie Chart. It 
is followed by an example of menu use in 
such a design, divided into three 
phases--~creating the pie chart, 
enhancing the chart, and modifying the 
chart. 


Designing a Pie Chart 


A pie chart plots one variable, referred 
to as the data variable, from the data 
file. A second variable, called the 
label variable, can serve as a source of 
labels for your chart or you can supply 
the labels as enhancements. Effective 
pie charts have a limited number of seg- 
ments, often no more than 8. If the 
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data results in a segment of less than 2 
degrees, a warning message is returned: 
you should select a subset of the data 
file for plotting so that the segments 
and labels will be more than 2 degrees 
and thus discernable when drawn. 


The following simple example illustrates 
the steps required to design a basic pie 
chart such as the one shown in figure 
4-5. Suppose you want to draw a pie 
chart showing the breakdown of a budget 
by department. To do so, perform the 
steps described below at your terminal. 


PUBLICITY 
2700 


PERSONNEL 
1280 





Figure 4-4. Pie Chart without Enhancements 
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1. After logging on to the system at the 


4, 


graphics terminal, type 
RUN GRAPH. PUB.SYS 


GRAPH displays the MAIN CONTROL 
menu on your screen. 


. On the MAIN CONTROL Menu, type A; 


then type in FIRSTCHART for Chart 
Name and CFi for Chart File Name. 
Press ENTER. 


You are telling GRAPH that you 
want to create a chart named 
FIRSTCHART to reside in a file 
named CF1. 


. On the CHART DESIGN CONTROL type F 


and press ENTER. 


You are telling GRAPH that you 
want to build a data file. 


Fill out the DATA PROMPT Menu as fol- 
lows, pressing TAB to go to the next 
field, or Control TAB to go back to 
the previous field: 
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File name: FINANCE 


VAR 1 VAR 2 

name type name type 
DEPT T TOTAL N 
R&D 1790 

SALES 1548 

QA 1050 
PERSONNEL 1280 
PUBLICITY 2700 


When you are done, press ENTER. 


You are giving your data file a 
name (FINANCE) and specifying 
two variables. DEPT is a text- 
ual variable; Total is a 
numeric variable. You then 
enter the values for the var- 
tables. When you press ENTER, 
the cursor scans the screen 
and returns to the top of the 
sereen when finished. 


Press NEXT, which is shown on the 
bottom of the menu to be f6. 


GRAPH brings you to the DATA DEF- 
INITION Menu. 


By 


6. 


On the DATA DEFINITION Menu, type 
FINANCE next to Data File Name and 
press ENTER. 


Press DONE (f7) 


You are naming your data file 
FINANCE. GRAPH fills in the 
necessary fields from the inform- 
ation you specified in the DATA 
PROMPT Menu. GRAPH returns you 
to the CHART DESIGN CONTROL 

Menu. 


On the CHART DESIGN CONTROL Menu, 
type C next to Selection, type P 
for Chart Type, and Press ENTER. 


You are specifying your chart 
to be a pie chart. 


On the PIE CHART Menu, type TOTAL 
next to Data Variable, type DEPT 
next to Label Variable, and press 
ENTER. 


You want the pte segments to re- 
present the amounts given by the 
variable TOTAL, and to be labeled 
by DEPT. 
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8. Press DRAW (f3). 


GRAPH returns a message in the 

message window telling you that 
tt ts preparing the data. The 

pie chart in Figure 4-4 should 

appear on your terminal. 


Note: This example continues below after 
a general discussion of pie chart 
enhancements. Keep GRAPH running on 
your terminal as you read on. If you do 
not wish to go further at this time, 
press DONE (f7), type E on the CHART 
DESIGN CONTROL Menu, and press ENTER. 


Optional Pie Chart Enhancements 


There are optional enhancements that you 
may add if you wish. The enhancements 
that are listed here can be added in any 
combination <r order. Refer to the spe- 
cifications at the end of this section 
for information on filling out each par- 
ticular chart. 


To redirect output to a plotter or the 
Laser printer, enter a G on the CHART 
DESIGN CONTROL Menu and fill out the 
GRAPHING OPTIONS Menu. 


To arrange the segments in the order of 
occurrence in the data file rather than 
ascending order, enter a C and P in 

the CHART DESIGN CONTROL Menu and blank 
out the sort field in the PIE CHART 
Menu. 


To specify colors or textures, enter an 
GL in the CHART DESIGN CONTROL Menu or 
press NEAT from the PIE CHART Menu and 
fill out the PIE CHART LABELS Menu. 


To add labels or later modify the exist- 
ing labels, type the segment labels in 
the PIE CHART LABELS Menu. (GRAPH 
places labels outside the segments; to 
place labels inside the segments use the 
ANNOTATIONS Menu. ) 


To label each segment with percentages 
calculated from the data file, type any 
character in the "Print Percentages’ box 
in the PIE CHART Menu. 
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To explode a segment, enter an explosion 
specification expression in the PIE 
CHART Menu. 


To specify size, color, and font for all 
standard text, enter JC on the CHART 
DESIGN CONTROL Menu and fill out the PIE 
TEXT CONTROL Menu. (To map the four 
available fonts to the font numbers, en- 
ter FD on the CHART DESIGN CONTROL 

Menu and fill out the FONT DEFINITION 
Menu. ) 


To add titles or footnotes, press NE&T 
(f6) from the PIE CHART LABELS Menu or 
enter TI on the CHART DESIGN CONTROL 
Menu and fill out the PIE CHART TITLES 
Menu. 


To annotate the chart, enter A on the 
CHART DESIGN CONTROL Menu or press NEAT 
from the PIE CHART TITLES Menu and fill 
out the ANNOTATIONS Menu. 


To select a subset of the data, enter a 
subset specification expression on the 
PIE CHART Menu. 


To create new data mathematically, enter 
a T on the CHART DESIGN CONTROL Menu 

and fill in the DATA TRANSFORMATIONS 
Menu. 


BUDGET ANALYSIS 


FISCAL YEAR 1980 


PUBLICITY 
32.3 % 


QUALITY ASSURANCE 
12.5 % 


RESEARCH AND DEVELOPMENT 
21.4 % 


PERSONNEL 
15.3 % 


SALES 
18.5 % 


PREPARED FOR INTERNAL USE 
BY DSG/3000 





Figure 4-5. Pie Chart with Enhancements 
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Enhancing A Pie Chart 


To add enhancements to the basic pie 
chart so that your chart looks like fig- 
ure 4-5, perform the steps below. 


If you have exited from GRAPH since cre- 
ating the basic pie chart FIRSTCHART, 
described above, you should return it to 
the current chart status now, to con- 
tinue the example. To do so, log on, 
run GRAPH, enter an M, FIRSTCHART, 


and CFi on the MAIN CONTROL Menu, and 10. 


enter a C and P on the CHART DESIGN 
CONTROL Menu. Press DRAW to see the 
graph. 

9. Press SHIFT-G DSP. 


You are turning off the graphics 
display. 


Press SHIFT-A DSP. 


You are turning on the alphanu- 
meric display. 
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In the PIE CHART Menu, space over 
the first field under Options to 
blank it out. Then type any char- 
acter in the second field. Press 
ENTER. 


You are telling GRAPH to label 
the segments with percentages. 


Press DRAW (f3). 
Press SHIFT-G DSP and SHIFT-A DSP. 


You are turning off the graphics 
display and turning on the alpha- 
numeric display. 


On the PIE CHART Menu, enter this 
“explosion specification: 


DEPT="R&D" 


In exploston or subset spectfi- 
cations, quotes are required 
around expressions containing 
blanks. 


Law 


12. 


Press ENTER, and then DRAW (f3). 
The R & D segment its exploded. 
Press NEXT. (F6) 


You are indicating that you want 
to go on to the PIE CHART LABELS 
Menu. 


On the PIE CHART LABELS Menu, enter 
the following segment labels in the 
third column: 


QUALITY ASSURANCE 
PERSONNEL 
SALES 


RESEARCH AND DEVELOPMENT 13. 


PUBLICITY 
Press ENTER 


Rather than take labels from the 
data file, you name them here in 
the desired form, replacing R & D 
with RESEARCH AND DEVELOPMENT and 
QA with QUALITY ASSURANCE. WNote 
that the segments are labeled 
clockwise from the two o'clock 
position. (Turn on the graphics 
display to review the graph.) 


Press NEXT (f6) to go on to TITLES 
Menu. 
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Fill in the TITLES Menu as follows: 


Title: BUDGET ANALYSIS 
Subtitle: FISCAL YEAR 1982 
Footnote: PREPARED FOR INTERNAL 


USE BY [YOUR NAME] 


When you are done, press ENTER and 
then DRAW. 


You are adding a title, subtitle, 
and footnote. The pie chart in 
Figure 4-6 should appear on your 
graphics device. 


Press SHIFT-G DSP and SHIFT-A DSP. 
Press DONE (f7) 


After you turn off the graphics 
display and turn on the alpha- 

numeric display, GRAPH returns 

you to the CHART DESIGN CONTROL 
Menu. 


Type "E" and press ENTER 


You exit from GRAPH. The colton 
(:) prompt indicates that you 
have been returned to the operat- 
ing system. 


BUDGET ANALYSIS 
FISCAL YEAR 1982 


MANUFACTURING 
28.1 % 


QUALITY ASSURANCE 


PERSONNEL 


RESEARCH AND DEVELOPMENT 
15.4 % 


PREPARED FOR INTERNAL USE BY GRAPHO MARKS 





Figure 4-6. Modified Pie Chart 
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Modifying A Pie Chart 


Suppose you want to make the following 
modifications to the pie chart: 


-- add the MFG Department to the data Les 


file 

-- print the label MANUFACTURING next to 
the graph 

-- add surface textures and vary the 
type fonts to make the graph more 
interesting visually 


Perform the following steps at your ter- 

minal (if you have not logged off, ig- 

nore steps 14 and 15): 

14. Log on and enter GRAPH: 
RUN GRAPH. PUB.SYS 

15. On the MAIN CONTROL MENU, type M; 
then type in FIRSTCHART for Chart 
Name and CFi for Chart File. Press 
ENTER . 


16. On the CHART DESIGN CONTROL MENU, 
type F and press ENTER. 
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You inform GRAPH that you want to 
modify the chart named FIRSTCHART 
in file CF1. You then ask to see 
the data file. 


On the DATA PROMPT Menu, type in 
FINANCE for File name and press 
ENTER. 


On the first blank line, type MFG 


in the first column and 3264 in 
the second column. 


You are adding a data entry. 
Press ENTER 
GRAPH displays a warning message: 
"WiLL Overwrite File: FINANCE 
Press ENTER to confirm" 
Press ENTER again. 
When the file has been modified, 
the cursor returns to the top of 
the screen and the warning mes- 


sage 1s cleared. 


Press DONE (f7). 


18. 


19. 


On the CHART DESIGN CONTROL Menu, 20. 


type Z and press ENTER. 


You are indicating that you want 
to enhance the chart labels. 


On the PIE CHART LABELS Menu, add 


MANUFACTURING to the end of the 216 


list of segment labels. Press EN- 


TER. 


You are labeling the MFG seg- 
ment. MFG is the last segment 
because it has the largest data 
value in the data file. 


In the column labeled Texture, type 
2 opposite QUALITY ASSURANCE, 3 op- 
posite PERSONNEL, 4 opposite SALES, 
5 opposite RESEARCH and DEVELOPMENT, 
and 6 opposite PUBLICITY. Press 
ENTER. 


You are specifying textures for 
the segments of the pie. 


22. 


Press DONE. 


Returns you to the CHART DESIGN 
CONTROL Menu. 
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On the CHART DESIGN CONTROL Menu, 
type TC. Press ENTER. 


You are indicating that you wish 
to modify the graph using the 
PIE TEXT CONTROL Menu. 


On the TEXT CONTROL MENU, in the 
column labeled "Size," type 12 op- 
posite Main Title and 8 opposite 
Footnote. 


In the column labeled "Font," type 
3 opposite Main Title and 
Footnote. Press ENTER. 


In the Size colum you are 
changing the size of the type 
used in the Main Title and 
Footnote. In the Text colum, 
you are changing the type font 
used for the Main Title and 
Footnote. 


Press DONE (f7). 


On the CHART DESIGN CONTROL Menu, 
type G. Press ENTER. 


You are moving to the GRAPHING 
OPTIONS Menu. 


23. On the GRAPHING OPTIONS Menu, under 


Device, type S over the default H 
opposite TEXT. 


Press ENTER. 
Press DRAW. 


You are making the four software 
fonts available for use. You have 
specified the use of one of these 
fonts in step 16. Only one hard- 
ware font is available. 
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NOTE: To plot the chart that is 

now drawn, you must enter 

the Device identification and HP- 
IB address. Once you change the 
identification of the output device, 
it becomes the default device 

and when you press DRAW, DSG/3000 
will attempt to plot your chart ra- 
ther than draw it on the screen. 

You have to change your Device ID on 
the GRAPHING OPTIONS Menu back to 
the number of your terminal if you 
wish to draw to the screen again. 


Designing a Line Chart 
or Scattergram 


FDI TC 


DATA 
TRANSFORMATIONS 


NEXT VARIABLE 
QUALIFICATIONS 
TITLES 
LINE CHART 
LEGENDS 
LINE CHART P LABEL 
AXES PROMPT 
ANNOTATIONS 
GRAPHING 
OPTIONS 
BAR AND LINE 
CHART TEXT CONTROL 


FONT 
DEFINITION 


Figure 4-7. Line Chart Road Map (required menus are shaded) 
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In a line chart or scattergram, all of 
the variables must be numeric. There 
can be up to 8 Y-axis variables, each 
represented by a different line texture 
(or different markers for scattergrams) 
scaled along the Y-axis. There is one 
independent variable, usually scaled 
along the X-axis. 


Figure 4-7 shows the routing of the 
menus used in designing a line chart or 
scattergram from the CHART DESIGN 
CONTROL Menu. The required menus are 
shaded. Each menu is explained is 
Section V. 





Figure 4-8. 


Basic Line Graph 


A basic line chart like the one in Fig- 
ure 4-8 can be designed by completing 
the shaded menus in Figure 4-7 (MAIN 
CONTROL, CHART DESIGN CONTROL, DATA DE- 
FINITION and LINE CHART Menus, and DATA 
PROMPT if a data file does not already 
exist). Pressing DRAW at this point 
will produce: 


-- a line chart on the graphics ter- 
minal, with every data point plotted 

-- each dependent variable represented 
by a line of a different texture 

-- each line texture has a legend 
labeled with the data variable name 

-- axes are scaled according to the data 
and marked with labeled ticks 

-- no data markers, no grid lines 

-- no titles, footnotes, or annotations 

~~ stick font used for all text on 
charts 


To create a scattergram, you must spe- 
cify the scattergram option on the LINE 
CHART Menu. Otherwise, the scattergram 
is designed in the same way as the line 
chart. 
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Line Chart Enhancements 


You can add any of the following en- 
hancements to the basic line graph. 

specifications in Section V give in- 
formation about each particular menu. 


The 


To redirect output to a plotter or Laser 
printer, enter a G on the CHART DESIGN 
CONTROL Menu and fill out the GRAPHING 
OPTIONS Menu. 


To select a subset of the data, enter a 
C on the CHART DESIGN CONTROL Menu and 
enter a subset expression on the LINE 
CHART Menu. 


To qualify the data, press NEXT from the 
LINE CHART Menu and enter a qualifi- 
cation expression. (See Section III for 
information on subsets and qualifi- 
cations.) 


To create new data mathematically, enter 
a TF on the CHART DESIGN CONTROL Menu 

and enter a transformation expression on 
the DATA TRANSFORMATIONS Menu. 


To use logarithmic scaling or otherwise 
modify the axes in terms of minimum and 
maximum, major and minor ticks, tick 
labels and grid lines, enter an X on 
the CHART DESIGN CONTROL Menu and fill 
in the LINE CHART AXES Menu. 


To provide different labels for the 
major tick marks, enter a P (Prompt) 
next to Labels on the LINE CHART AXES 
Menu, press ENTER and NEXT, and fill in 
the LABEL PROMPT Menu. 


To specify different textures or le- 
gends, or to add data markers or colors, 
enter an LZ on the CHART DESIGN CONTROL 
Menu or press NEXT on the LINE CHART 
AXES Menu (or LABEL PROMPT Menu if used) 
and fill in the LINE CHART LEGENDS Menu. 
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To specify titles, footnotes, or axes 
titles, enter TI on the CHART DESIGN 
CONTROL Menu or press NEXT from the LINE 
CHART LEGENDS Menu and fill in the 
TITLES Menu. 


To specify color, size and font for all 
standard text, enter TC on the CHART 
DESIGN CONTROL Menu and fill out the 
BAR/LINE TEXT CONTROL Menu. (To map the 
four available fonts to the font num- 
bers, enter FD on the CHART DESIGN 
CONTROL Menu and fill out the FONT 
DEFINITION Menu. You then specify soft- 
ware text on the GRAPHING OPTIONS Menu. ) 


To annotate the chart, enter A on the 
CHART DESIGN CONTROL Menu and fill in 
the ANNOTATIONS Menu. 


Designing A Bar Chart 


DATA 
TRANSFORMATIONS 
NEXT VARIABLE 
QUALIFICATIONS 
TITLES 
LINE CHART 
LEGENDS 
LINE CHART P LABEL 
AXES PROMPT 
ANNOTATIONS 
GRAPHING 
OPTIONS 
BAR AND LINE 
CHART TEXT CONTROL 


FONT 
DEFINITION 


Figure 4-9. Bar Chart Road Map (required menus are shaded) 
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Figure 4-9 shows the routing of the 
menus used in designing a bar graph 


from the CHART DESIGN CONTROL Menu. 


Required menus are shaded. 


jables, each represented by a different 


bar texture and containing numeric data. 
There is only one X-axis variable which 


A bar chart can have up to 8 Y-axis var- 
can be either numeric or textual. 
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Basic Bar Graph 
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Figure 4-10. 


A basic bar chart can be produced by 
completing the shaded menus in Figure 
4-9 (MAIN CONTROL, CHART DESIGN CONTROL, 
DATA DEFINITION and BAR CHART Menus, and 
DATA PROMPT if a data file does not al- 
ready exist). Pressing DRAW at this 
point will produce: 


-- a bar chart on the graphics terminal 
with stacked, vertical bars 

-- y variables represented by bars of 
different textures 

~- each texture has a legend labeled 
with the variable name 

-- Y-axis with labeled ticks 

-- the independent variable is labeled 

-- axes are scaled according to the data 

-- no grid lines 

-- no titles, footnotes, or annotations 
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Bar Chart Enhancements 


You can add any of the following 
enhancements to the basic bar graph. 

The specifications in Section V give in- 
formation about each particular menu. 


To redirect output to a plotter or Laser 
printer, enter a G on the CHART DESIGN 
CONTROL Menu and fill out the GRAPHING - 
OPTIONS Menu. 


To subset the data, enter a C on the. 
CHART DESIGN CONTROL Menu and enter a 
subset expression on the BAR CHART Menu. 


To qualify the data, press NEXT from the ~~ 


BAR CHART Menu and enter a qualification 
expression. (See Section III for infor- 
mation on subsets and qualifications. ) 


To create new data mathematically, enter 
a TF on the CHART DESIGN CONTROL Menu 

and enter a transformation expression on 
the DATA TRANSFORMATIONS Menu. 


To use logarithmic scaling or otherwise 
modify the axes in terms of minimum and 
maximum, major and minor ticks, tick 
labels, number of bars, bar labels, and 
grid lines, enter an X on the CHART 
DESIGN CONTROL Menu and fill in the BAR 
CHART AXES Menu. 


To provide different labels for the 
major tick marks, enter a P (Prompt) 
next to Labels on the BAR CHART AXES 
Menu and Press ENTER; then press NEXT 
and fill in the LABEL PROMPT Menu. 


To specify different textures or 
legends, or to add colors, enter an L 
on the CHART DESIGN CONTROL Menu or 
press NEXT from the BAR CHART LEGENDS 
Menu and fill in the TITLES Menu. 


To specify main title, subtitle, axis 
titles or footnote, enter TI on the 
CHART DESIGN CONTROL Menu or press NE&T 
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from the BAR CHART LEGENDS Menu and fill 
in the TITLES Menu 


To specify color, size, and font for all 
standard text enter TC on the CHART 
DESIGN CONTROL Menu and fill out the 
BAR/LINE TEXT CONTROL Menu. (To map the 
four available fonts to the font num- 
bers, enter FD on the CHART DESIGN CON- 
TROL Menu and fill out the FONT DEFINI- 
TION Menu and specify software text on 
the GRAPHING OPTIONS Menu. ) 


To annotate the chart, enter A on the 
CHART DESIGN CONTROL Menu and fill in 
the ANNOTATIONS Menu. 


Designing A Slide 


GRAPHING 
OPTIONS 
FONT DEFINTION 





Figure 4-11. Slide Road Map (required 
menus are shaded) 


GRAPH allows you to design a slide con- 
Sisting of text, boxes, arrows, and 
lines without plotting variables from a 
data file. As with other graphs, the 
output can be directed to a plotting 
device that draws on paper or trans- 
parencies. Figure 4-12 shows the rout- 
ing of the menus used to design a slide. 
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A slide is designed as a series of an- 
notations. To reach the ANNOTATIONS 
Menu, enter a C for Chart Type on the 
CHART DESIGN CONTROL Menu (an S for 


Slide, the default chart type, is al- 
ready printed on the Menu). Then enter 
each element of the slide as a separate 
annotation. (See the ANNOTATIONS Menu in 
Section V.) 


The annotations are drawn on your graph- 
ics terminal by default. To draw the 
slide on a graphics plotter, fill in the 
GRAPHING OPTIONS Menu appropriately. 


Note: the maximum number of annotations 
per chart is 20. 


Utilities 


All of the GRAPH Utilities can be 
executed from the MAIN CONTROL Menu. 
After filling the appropriate fields, 
press ENTER. 


Drawing a Chart or Chart File 


You can draw all of the charts in a 
chart file by entering a D under OPER- 
ATION along with the chart file name. 
GRAPH pauses after drawing each chart. 
When you press CONTINUE (f2), GRAPH 
draws the next chart. If you want the 
charts drawn without pauses, type any 
character in the first option field un- 
der DRAW. 


Alternatively, you can draw a single 
chart by entering a chart name as well 
as the chart file name on the MAIN CON- 
TROL Menu. 


You can override the device that was 
specified for each chart when it was de- 
signed by typing in a device model 
number and HP-IB address in the option 
fields under DRAW. Device model numbers 
and HP-IB addresses are given in Section 
V under the GRAPHING OPTIONS Menu. 


4-3 


Copying a Chart 


Before you start modifying an existing 
chart, you might want to make a copy of 
it to save in case you want to refer to 
the original again. GRAPH allows you to 
copy a chart into the same chart file or 
into a different one in your current 
group by entering a C under OPERATIONS 
along with the name of the new copy of 
the chart and its chart file. Enter the 
names of the original chart and chart 
file in the fields under COPY CHART. 


Purging a Chart 


To purge a chart, enter a P under 
OPERATIONS along with the name of the 
chart to be purged and the file in which 
it resides. When you press ENTER, GRAPH 
displays a warning message. You must 
press ENTER a second time to purge the 
chart. 


Browsing a Chart File 


If you enter a B under OPERATIONS 

along with a chart file name, GRAPH re- 
turns information about all of the 
charts in the chart file. The inform- 
ation includes chart name, chart type, 
and comments that may have been entered 
in the CHART INFORMATION Menu. The 
CHART BROWSE Menu can be used as an in- 
dex to the chart file. 


Supplying and Displayin 
Short information: dks 


If you enter an I under OPERATION 

along with the names of the chart and 
chart file, a page of information is re- 
turned, including chart name, chart 
type, creation date, creator's logon 
name and account, and comments. Only 
the comments field can be modified. 
(Remember to press ENTER after typing in 
comments.) These comments will also be 
displayed when you browse the chart 
file. 
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Creating Figure Files 


If you enter CF, the FIGURE FILE Menu 
will appear on your screen. Figure 
files are your means of longterm storage 
of graphical information. They are used 
primarily for transporting graphical 
information from one office systems 
application to another. See Section 1 
for a complete description of additional 
features offered by this utility. 


SECTION 5 


Menu Specification 


This section contains reference specifi- 
cations for all of the GRAPH screen 
menus. For general discussions on using 
the menus, read Section IV, Using 
DSG/3000 Interactively (GRAPH). 


Annotations Menu 5-1 
Bar and Line Chart Text 

Control Menu 5-8 
Bar and Line Chart Titles Menu 5-11 
Bar Chart Menu 5-16 
Bar Chart Axes (Numeric) Menu 5-22 
Bar Chart Axes (Textual) Menu 5-28 
Bar Chart Legends Menu 5-34 
Chart Browse Menu 5-39 
Chart Design Control Menu 5-41 
Chart Information Menu 5-45 
Data Definition Menu 5-7 
Data Prompt Menu 9793 
Data Transformations Menu 5-58 
Figure File Menu 5-62 
Font Definition Menu 5-66 
Graphing Options Menu 5-69 
Label Prompt Menu 5-177. 
Line Chart Menu 5-80 
Line Chart Axes Menu 5-84 
Line Chart Legends Menu 5-90 
Main Control Menu 5-95 
Pie Chart Labels Menu 5-104 
Pie Chart Menu 5-100 
Pie Chart Titles Menu 5-109 
Pie Text Control Menu 5-113 


Qualifications Menu §-116 


Annotations Menu 


annotation: CA or M or BD) 





Figure 5-1. ANNOTATIONS Menu 


Use this menu to specify any of the FIELD EXPLANATION 

following annotations: boxes, lines, ar- 

rows, text. The plotting device must be 1. Function 

a graphics terminal or plotter in order Enter one of the following letters: 


to position the annotations. 
A To add a new annotation 
M To modify an existing annotation 
D To delete an existing annotation 
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2. Type (for adding only) pe 
A Arrow 
L Line 
B Box 
T Text containing any combination of 


printable characters 


3. Color 


This field has meaning only when the 
graph is drawn on a color device. 
Enter one of the following numbers: 


1. Black (default) 
2. Red 

3. Green 

4. Blue 

5...16 


This presumes that the pens 1-4 are 

inserted in the plotter in this or- re 
der. (See Appendix A for information 

about colors.) 


. Texture 


This field is for arrows, lines, and 
boxes. Enter one of the following 
numbers: 


For arrows, lines, and boxes: 








8 esesevneveveseses 


Text (textual annotations only) 
Enter the annotation as you want it 
printed. It can consist of any com- 
bination of up to 51 printable char- 
acters. 


Size (textual annotations only) 
Enter a number from 1 to n where 1 
is the smallest text size. The de- 
fault is 3. 


On plotters, software and hardware 
characters will be the same size. 

On terminals, hardware characters 
are larger than the software char- 
acters. Refer to the GRAPHING OP- 
TIONS Menu for a discussion of hard- 
ware and software characters. 


Angle (textual 
Enter a number 
represents the 
clockwise from 


annotations only) 
from 0 to 359 that 
angle counter- 

the origin along 


which the text is to be printed. 
The default is 0. See Figure 5-2. 


If the graph is drawn using hardware 
characters, specified in the 
GRAPHING OPTIONS Menu, the anno- 
tations can only be drawn at 0, 90, 
180, or 270 degrees on terminals. 
Plotters will draw at any angle. 


Justification (textual annotations 
only) 

Enter one of the letters listed 
below: 


The text will be drawn with the Note: The default is L. 
left-most character located at 


the digitized font. 9. Font (textual annotations only) 

Enter a number, 1-4, corresponding 
The text will be drawn with the to a font number specified in the 
midpoint of the the text located FONT DEFINITION Menu. The default 
at the digitized point. (font 1) is the Stick font. 


The text will be drawn with the 
right-most character located at 
the digitized point. 
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Figure 5-2. Text Angles 


ae! 


DISCUSSION 


Each chart or slide can contain up to 20 
annotations. 


Adding Annotations 


To add an annotation on the graphics 
terminal, follow these steps: 


l. Type an A in the first field of 
the menu. 


2. Fill in the second field according 
to the type of annotation being 
added. 


3. If the annotation is textual, fill 
in field 5. All the other fields 
are optional. 


4, Press ENTER. GRAPH returns a message 
in the message window telling you to 
position the graphics cursor to the 
start location for this annotation 
(see Table 5-1). 


5. Move the graphics cursor, originally 
positioned at the end position of 
the most recent annotation, to the 
screen, to the start position by 
using the Graphics Cursor Keys 
(labeled with arrows on your 
terminal). 


6. Press the return key to digitize the 
point. 
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7. For arrows, boxes, and lines, you 
must position the graphics cursor to 
the end location and press the space 
bar again. 


The annotation is then drawn on your 
screen. If you wish to add another an- 
notation, you can repeat the entire pro- 
cess. 


If a graphics plotter is being used to 
draw the chart, follow the same pro- 
cedures with one exception. To position 
the annotation, move the pen holder on 
the plotter to the desired point and 
press the ENTER key on the plotter while 
the light on the ENTER button is turned 
on. 


Table 5-1. Start and End Locations for 
Annotations 






Annotation 











Arrow Tail End Arrow Head 


Box One corner Diagonal corner 
Line Either end The other end 
Text: 


Left justified | First character of text 
Right justified | Last character of text 
Centered Center of text 










Modifying Annotations 


To modify an annotation on the graphics 
terminal, follow these steps: 


1. If the annotations are not already 
displayed, draw the chart by pres- 
sing f3 (DRAW). 


2. Press PRV ANOT (f1) to position the 
graphics cursor to the most recent 
annotation. 


3. If the current annotation is not the 
one you want to modify, press PRV 
ANOT (f1) again to step backwards 
through all the annotations until 
you reach the one you want. 


Notice that pressing NXT ANOT (f2) 
brings you forward through the same 
sequence. If you have modified an 
annotation -- for example 8 -- and 
you wish to modify 9, pressing f2 
will bring to the screen the fol- 
lowing error message, “Next an- 
notation not available." To modify 
9, it is necessary to step back- 
wards (using F1) through annotations 
until you reach 9 again. This oc- 
curs because modifying an annotation 
moves it to the end of the list. 


Ee 


If the menu is not displayed, turn 
on the alphanumeric display by pres- 
sing SHIFT-A DSP. 


5. Type an M in the first field of 
the ANNOTATIONS Menu. 


6. If you are changing anything other 
than the position of the annotation, 
type in your corrections on the 
menu. 


7. Press ENTER. 


8. Follow the positioning procedure 
used in adding annotations to re- 
locate the current annotation if de- 
sired. 


GRAPH will draw the modified annotation 
on your screen. Notice that the former 
version is not erased, but if you draw 

the chart again only the modified ver- 

sion appears. 


If a graphics plotter is being used to 
draw the chart, follow the same pro- 
cedures with one exception. To position 
the annotation, move the pen holder on 
the plotter to the desired point and 
press the ENTER key on the plotter when 
the light on the ENTER button is turned 
on. Notice that when you press fl or f2 
on the terminal, the pen holder 
positions itself to the current annota- 
tion on the plotter. 


Deleting Annotations 


To delete an annotation, follow steps 
1-4 above for modifying. Then enter a 
Din the first field of the AN- 
NOTATIONS Menu and press ENTER. 


FUNCTION KEYS 


PRV ANOT (f1) If the plotting device is 
a graphics terminal, fl first turns on 
the graphics cursor, positions it to the 
most recent annotation and displays its 
specifications on the menu. 


Thereafter, pressing fl positions the 
graphics cursor to the previous an- 
notation and displays its spe- 
cifications. If the plotting device is 
a plotter, it positions the pen holder 
instead of the cursor. 


NXT ANOT (f2) If the plotting device is 
a graphics terminal, f2 positions the 
graphics cursor to the next annotation 
and displays its specifications. If the 
plotting device is a plotter, the pen 
holder is positioned instead of the cur- 
sor. 


DRAW (f3) Draws the current chart. 


REFRESH (f4) Refreshes the screen by re- 
drawing the menu with the specifications 
of the current annotation. Also clears 
the graphics display. 


PREVIOUS (f5) Goes to PIE CHART TITLES 
Menu if the chart type is a pie chart, 
or goes to BAR AND LINE CHART TITLES 
Menu if the chart type is a line or bar 
chart. If you are designing a slide, it 
goes to the CHART DESIGN CONTROL Menu. 


NEXT (f6) Goes to GRAPHING OPTIONS Menu. 


DONE (f7) Goes to CHART DESIGN CONTROL 
Menu. 


HELP (f8) Initiates the Help Facility, 
giving an explanation of the ANNOTATIONS 
Menu. 


ROADMAP 










TITLES Menus 
(Pie, Line, or Bar} 


CHART DESIGN 
CONTROL Menu 
GRAPHING OPTIONS 
Menu 





PREVIOUS 









When creating a slide and not plotting to annotate a graph, enter A on the 
data, enter C (Select Chart Type) and CHART DESIGN CONTROL Menu, or press NEXT 
S (Slide) on the CHART DESIGN CONTROL from -one of the TITLES menus or press 
Menu to get to this menu. If you want PREVIOUS from the GRAPHING OPTIONS Menu. 
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Bar and Line Chart Text Control 


ceti Avis Title: 


Bottom Axis Title: 


TT: 4] 


Footnote: 


Y Axis Labels: 
Y Axis Labels: 


Legend Text: 





Figure 5-3. BAR AND LINE CHART TEXT CONTROL Menu 


Use this menu to specify color, size, 
and font for text on a bar or line 
chart. This includes titles, subtitles, 
axis labels, legend labels, and 
footnotes but not annotations. 
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FIELD EXPLANATION 


ds 


Color 

This field has meaning only when the 
graph is drawn on a color device. 
Enter 0-16 or blank. (Entering 0=1.) 


1 Black (default) se 
2 Red 6.. 
3 Green Tews 
4 Blue 8...16 


The above presumes that pens 1-4 

are inserted in the plotter in the 
order shown. (See Appendix A for 
information about colors.) The max- 
imum number that can be entered is 
16. The default (blank) is 1. 


Size 

Enter a number from 1 to 74 

where 1 is the smallest text size 
and 72 is the largest. The defaults 
(blanks) use the following sizes: 


Main Title 
Subtitles 

Left Axis Title 
Bottom Axis Title 
X Axis Labels 

Y Axis Labels 
Legend Text 


WE Ulu ON om 


On plotters, software and hardware 
characters will be the same size. 

On terminals, hardware characters 
may be larger than the software 
characters. Refer to GRAPHING OP- 
TIONS Menu for a discussion of hard- 
ware and software characters. 


Note: SIZE of text will reflect 
chart size changes and SIZE is re- 
lative rather than absolute. If you 
have reason to shrink or stretch the 
size of a chart, you may wish to ad- 
just the SIZE specifications for 
your text to ensure legibility. 


FUNC 


Font 

Enter a number from 1 to 72 

you have defined for your chart 
using the FONT DEFINITION Menu. 
Four software fonts may be defined 
for a single chart. The default 
(blank) is font 1. 


Only one hardware font may be used. 
See GRAPHING OPTIONS for more in- 
formation about software and hard- 
ware fonts. 


TION KEYS 


DRAW (f3) Draws the current chart. 


REFRESH (f4) Refreshes the screen by re- 
drawing the menu with the specifications 


for 
ENTE 


color, size, and font as of the last 
Ri 


PREVIOUS (f5) Goes to GRAPHING OPTIONS 
Menu. 


NEAT 


DONE 


(f6) Goes to FONT DEFINITION Menu. 


(f7) Goes to CHART DESIGN CONTROL 


Menu. 


HELP 
ing 
TEXT 


(f8) Initiates Help Facility, giv- 
an explanation of BAR AND LINE CHART 
CONTROL Menu. 


ROADMAP 
GRAPHING 
OPTIONS Menu 
CHART DESIGN 
CONTROL Menu 
FONT DEFINITIONS 
Menu 


If you are designing a Bar and Line FONT DEFINITION or NEXT from the 
Chart and enter ZC on the CHART GRAPHING OPTIONS menus also brings 


DESIGN CONTROL Menu, this menu it up. 
appears. Pressing PREVIOUS from 
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Bar and Line Chart Titles Menu 


Main Title: 


Subtitle: 


X Axis Title: 


Footnote: 


Figure 5-4. 


You may specify title, subtitle, axes 
titles, and footnotes for line charts, 
bar charts, and scattergrams with this 


menu. 


FIELD EXPLANATION 


1. Title 


The title may be any combination of 


up to 45 printable characters. 


Pig ob 





BAR AND LINE CHART TITLES Menu 


Subtitle 

The subtitle is printed in a smaller 
text size than the title and con- 
tains up to 64 printable characters. 


Left Vertical Axis Title 

This title may contain contain up to 
78 printable characters, and will be 
justified with the left vertical 
axis when drawn. 


4. Horizontal Axis Title 
This title may up to 78 printable 
characters, and will be centered be- 
neath the horizontal axis when 
drawn. 


5. Footnote 
The footnote may contain up to 78 
printable characters. 


DISCUSSION 


The following features can be entered on 
this menu: 


title 

subtitle 

left vertical axis title 
horizontal axis title 
footnote 


* * F KR * 


All sizes can be specified using the BAR 
AND LINE TEXT CONTROL Menu. If the sizes 
specifications are changed, the maximum 
number of printable characters listed 
above may be affected. 


In every case, GRAPH will left-justify 
the text that you enter. When the ti- 
tles are actually drawn on the graph, 
the left axis title is left-justified, 
and all other titles are centered. 


Any of the titles entered in this menu 
can include any of the following special 
commands: 


$TODAY Represents the current date in 
the form mm/dd/yy with leading 
zeros suppressed. For example, 


2/15/82. 


$MONTH Represents the current month 
spelled out in full. For ex- 
ample, FEBRUARY. 


$M Represents the current month 
numerically. For example, 2. 


$DAY Represents the current numeric 
day of the month. For example, 
L5. 

$YEAR Represents the current year in 


4 digits. For example, 1982. 


$Y Represents the current year by 
its last two digits. For ex- 
ample, 82. 


For example, you might specify this sub- 
title: 


THIS GRAPH WAS PRODUCED ON $TODAY 


When the graph is drawn, the subtitle 
would be: 


THIS GRAPH WAS PRODUCED ON 2/15/82 


The titles entered on this menu can be 
suppressed when the graph is actually 
drawn by filling in the GRAPHING OPTIONS 
Menu appropriately. 
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FUNCTION KEYS 

DRAW (f3) Draws the current chart. 
REFRESH (f4) Refreshes the screen by re- 
drawing it with the information entered 


as of the last ENTER. 


PREVIOUS (f5) Goes to LINE CHART LEGENDS 
or BAR CHART LEGENDS Menu. 


NEXT (f6) Goes to ANNOTATIONS Menu. 


DONE (f7) Goes to CHART DESIGN CONTROL 
Menu. 


HELP (f8) Initiates Help Facility, giv- 
ing an explanation of the BAR AND LINE 
CHART TITLES Menu. 


CUMULATIVE SALES FIGURES 
eae SS TTLE 


VERTICAL AXIS TITLE CUMULATIVE SUBTITLE 


DOLLARS IN THOUSANDS. 


MONTHS «———— HORIZONTAL AXIS TITLE 


FOOTNOTE 
~—* (COMPANY CONFIDENTIAL) 





Figure 5-5. Standard Titles for Line and Bar Charts 
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ROADMAP 






CHART DESIGN 
CONTROL MENU 


Pressing TI on the CHART DESIGN CON- 
TROL Menu when you have specified that 
you are drawing a line or bar chart 
brings this menu to your screen. Alter- 


LEGENDS Menu 
(either BAR or LINE) 


T1 


ANNOTATIONS 
MENU 
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PREVIOUS 


natively, you can press NEXT from the 
BAR CHART LEGENDS or LINE CHART LEGENDS 
Menu when designing a line or bar chart 
or PREVIOUS from ANNOTATIONS. 


Bar Chart Menu 


Y Axis X Axis 
Variables Variable 


Options: , - Clustered Bars 
‘ot: - Horizontal Bars 


Data Subset Specification: Coptional) 





Draw Refresh Previous Next 





Figure 5-6. BAR CHART Menu 


This menu names the variables to be FIELD EXPLANATION 

plotted, selects a subset of the data, 

and specifies options such as horizontal 1. Y Axis Variables (dependent) 

or clustered bars. Fill in the names of the Y-axis var- 


iables as they were defined in the 
DATA DEFINITION Menu, or GRAPH re- 
turns a warning message. This is a 
required variable. You must specify 
at least one and no more than 8 
variables in this field. 
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2. 


X Axis Variable (independent) 

Fill in the name of the X-axis var- 
liable that will be plotted along the 
horizontal axis. (If you choose to 
have horizontal bars, this variable 
will actually be plotted on the ver- 
tical axis.) This variable name 
must also be defined in the DATA 


DEFINITION Menu, or GRAPH returns a 
warning message. 


If you leave this field blank, the 
bars will be labeled with numbers 
starting with 1. The X- and Y-axes 
may also be defined on the DATA 
TRANSFORMATIONS Menu. 





Figure 5-7. BAR CHART Menu Specifying Vertical Stacked Bars 


ea of 


Option: Clustered Bars 4, 
If you do not fill in this field, a 

bar graph plotting more than one 

Y-axis variable is drawn with 

stacked bars (see Figure 5-7). If 

you want the bars to be clustered, 

enter any character in this field 

(Figure 5-8). 


Note that if the data is scaled 
logarithmically (see the BAR AXES 
Menu) and more than one axis var- 
iable is used, the bars may not be 
stacked. 


X Axis 
Variable 


vs COUN 


Options: of - 


Option: Horizontal Bars 

If you do not fill in this field, 
bars are drawn vertically. If you 
enter any character in this field, 
the bars will be drawn horizontally; 
this means that the variables named 
in field 1 above are plotted on the 
horizontal axis and the variable 
named in field 2 above is plotted 
on the vertical axis. 


Clustered Bars 


A - Horizontal Bars 


Data Subset Specification: Coptional) 


Figure 5-8. 
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BAR CHART Menu Specifying Horizontal 
Clustered Bars 


Parentheses can be used to override the 
standard order of precedence: 


5. Data Subset Specification 
If you want to graph a subset of the 
data file, enter a subset spe- 
cification expression. In general, ke 
the expression has the form: 


Relational operators are processed 
from left to right 
2. NOT processed from left to right 


variablename relop value 3. AND and OR processed from left to 
cea variablename relop value [...]] right 
OR 


where relop is a relational 
operator from Table 5-2. For 
example, 


DEPT=SALES OR EXPENSES>800 


is a subset expression where DEPT 
and EXPENSES are names of variables 
in the data file. The variables 
used to specify the subset are not 
necessarily those being graphed. 


Table 5-2. Relational Operators For 
Subset Expressions 
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If you are stating the expression in 
terms of a textual variable whose 
value contains embedded blanks, use 
quotation marks or apostrophes around 
the value. 


Use quotation marks around a value with 
an embedded apostrophe; likewise use 
apostrophes around a value with embedded 
quotation marks. 


Examples 
DEPT="R & D" 
NAME= ~> "X" ' 


POSITION= "BOSS'S SON" 


DISCUSSION 


Bar charts are drawn with bars running 
vertically unless you specify horizontal 
bars. When there is more than one de- 
pendent (Y-axis) variable, the bars are 
stacked unless you specify clustered 
bars. The Y axis variables all must 
contain numeric data and must be spe- 
cified as numeric in the DATA DEFINITION 
Menu. 


Each one of the bar variables is repre- 
sented by a different bar texture. The 
single independent (or X-axis) variable 
(plotted on the horizontal axis if the 
bars are vertical) can be numeric, tex- 
tual, or left blank. If it is left 
blank, the X-axis will be labeled 1,2,3, 
and so forth at each bar. 


If the X-axis variable is time, the bars 
are usually drawn vertically. If the 
X-axis variable is not time, drawing the 
bars horizontally by designating the 
horizontal option will produce a clearer 
visual representation. 
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FUNCTION KEYS 
DRAW (f3) Draws the current chart 


REFRESH (f4) Refreshes the screen by re- 
drawing: it with the information entered 
as of the last ENTER. 


PREVIOUS (f5) Goes to the CHART DESIGN 
CONTROL Menu 
NEXT (f6) Goes to QUALIFICATIONS Menu. 


DONE (f7) Goes to CHART DESIGN CONTROL 
Menu. 


HELP (f8) Initiates Help Facility, giv- 
ing an explanation of the BAR CHART 
Menu. 


ROADMAP 
CHART DESIGN 
CONTROL MENU 
QUALIFICATIONS 
MENU 





PREVIOUS 


This menu appears when you can also reach it by pressing 
specify a Bar Chart from the PREVIOUS from the QUALIFICATIONS 
CHART DESIGN CONTROL Menu. You Menu when designing a bar chart. 
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Bar Chart Axes Menu (Numeric) 


istiad isa} T. 
Lig Labdei iype 





G - Quarters €7-4) 


{ - Years 


Figure 5-9. BAR CHART AXES (NUMERIC) Menu 


Specifies the characteristics of both 
axes for a numeric bar chart, including: 
scaling, spacing, and labeling of ticks, 
and grid lines. 
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In the numeric bar chart, all variables 
have been specified as numeric on the 
BAR CHART Menu. If the X-axis variable 
is textual or is left blank, GRAPH pre- 
sents the BAR AXES Menu (TEXTUAL) in- 
stead. 


FIELD EXPLANATION 


ee 


Type 

The Z that is entered in this field 
by default represents linear scaling. 
If you want logarithmic scaling in- 
stead, enter an O. Logarithmic 
scaling may be useful if the data 
takes values over a very large range, 
or if you want to draw a linear plot 
of two variables that have an ex- 
ponential relationship. 


Minimum 
Enter the minimum value for the axes. 
If this field is left blank, DSG/3000 
calculates the minimum from the data 
values. 


- Maximum 


Enter the maximum value for the axis. 
The maximum value must be greater 
than the minimum value. If you do 
not enter anything here, DSG/3000 
calculates the maximum from the data 
values. 


Interval Size 

Enter the number of units you want 
between major ticks in terms of the 
data. For example, if you want $100 
between ticks, enter 100. If you do 
not fill this in, DSG/3000 calculates 
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the units between ticks from the data 
in such a way that there are ap- 
proximately 5 intervals along the ax- 
is. If Type is logarithmic (0), this 
field represents the number of powers 
of 10 which will separate major tick 
marks. For example, a value of one 
means that every power of 10 will 
have a tick mark. 


Number of Minor Per Major Ticks 

Enter the number of minor tick marks 
between the major ticks. Minor ticks 
are drawn smaller than major ticks 
and are not labeled. If you do not 
fill in this field, there will be no 
minor ticks. For logarithmic charts, 
a common number of minor per major 
ticks is eight. Lowering this number 
results in a less dense axis or 
chart. 


. Draw Ticks on Right Axis 


If you want the Y-axis ticks to be 
drawm on the right axis as well as 

the left one, enter any character in 
this field. (If you opted for hori- 
zontal bars on the BAR CHART Menu, en- 
tering a character here causes the 
ticks to be drawn on the upper axis 

as well as the lower axis.) 


7. Draw Grid Lines 


If you want grid lines to be drawn 
wherever there are major ticks, enter 
any character here. 

. Draw Minor Grid Lines(Log scaling only) 
This field is ignored unless you have 
specified: 


log scaling (field 1) 
grid lines (field 7) 
number of minor ticks is >0 (field 5) 


If these conditions are satisfied and 
you type any character in this field, 
grid lines are drawn at minor ticks 
as well as major ticks. 


. Number of Tick Marks per Label 


If you leave this field blank or en- 
ter a1, every major tick will be 
labeled. Enter the number of major 
ticks per label. For example, if you 
want to label every other tick, enter 
a 2, which means that there will be 2 
ticks per label. 
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10.Label Type 
If you want the major ticks to be 
labeled according to the axis scal- 
ing, enter an W in this field. This 
is the default. If you want to sup- 
ply your own labels which might be 
textual rather than numeric, enter a 
P; after you have pressed ENTER for 
this menu, press NEXT and you can en- 
ter the labels on the LABEL PROMPT 
Menu. 


11.X-Axis Variable (display only) 
The name of the independent variable 
is displayed here. It cannot be al- 
tered. 


12.Minimum 
If you do not fill in this field, 
this axis is scaled according to the 
data. If you wish to leave more 
space before the first bar, enter a 
value less than the minimum value of 
the X-axis variable. 


13: 


14. 


a he 


Number of Bars 

If you do not fill in this field, 
DSG/3000 draws one bar for each data 
point. If you specify that you want 
a greater number of bars than there 
are data points, DSG/3000 leaves 
blank space for the remaining data 
values. If you specify fewer bars 
than there are data points, DSG/3000 
draws only as many bars as you 
request, starting from the beginning 
of the data file. For clustered bars, 
1 bar equals one cluster of bars. 


Number of Bars Between Grid Lines 

If you do not fill in this field, no 
grid lines are drawn parallel to the 
bars. If you want grid lines to be 
drawn, enter the number of bars be- 
tween grid lines. For clustered bars, 
each cluster counts as one bar. 


Bar Label Type 
Enter one of the following: 


N DSG/3000 calculates numeric 


labels from the axis scaling. 
(Default) 
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P Use this option if you want to 
enter your own bar labels which 
might be textual rather than nu- 
meric. After you have pressed EN- 
TER and then NEXT, GRAPH issues 
the LABEL PROMPT Menu. If you 
entered a P for both axes, you 
will fill in the LABEL PROMPT 
Menu twice. 


For convenience, GRAPH allows you to 
specify the following time or cal- 
endar labels regardless of the values 
of the X-axis variable. Fields 16 
and 17 are used with calendar labels 
to give the starting point and length 
of the labels. 


W Weekdays. Each bar will be 
labeled with a day of the week. 
If there are more than 7 bars, 
the labels will be repeated. 


M Months. Each bar will be labeled 
with the name of a month. If 
there are more than 12 bars, the 
labels will be repeated. 


16. 


17. 


Q Quarters. Each bar will be 
labeled with a quarter. If there 
are more than 4 bars, the labels 
will be repeated. 


Y Year. Each bar will be labeled 
with a year. 


Calendar Label Start (used only with 
time labels) 

Enter a number corresponding to the 
weekday, month, quarter, or year that 
labels the first (leftmost) bar. The 
default is 1, which corresponds to 
MON for weekdays, JAN for months, 
QTR1 for quarters, or 1 for year. 

For example, if you want the bars to 
be labeled by month beginning with 
November, type 212i in this field. 

If you want the bars to be labeled by 
years beginning with 1982, type 

1982 in this field. 


Calendar Label Length (used for time 

labels only) 

A Abbreviated label form is printed 
on the graph. (default) 
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L Long form is printed on the graph. 


Abbreviated Long 
Weekdays M MON 
Months J JAN 
Quarters Q1 QTR1 
Year N/A 1982 
DISCUSSION 


The X-axis is labeled with the name of 
the X-axis variable. 


If you do not fill in this menu, the 

axes characteristics take the following 

defaults: 

* linear axes 

* axes scaled according to the data 
values 

* major ticks with numeric labels cal- 

culated from the data 

no minor ticks or grid lines 


Note that calendar labels are blindly 
applied to tick marks, irrespective of 
the actual data. To avoid mislabeling, 
the X-axis interval size should be set 
to 1 in most cases. 


FUNCTION KEYS 

DRAW (f3) Draws the current chart. 
REFRESH (f4) Refreshes the screen by re- 
drawing it with the information entered 


as of the last ENTER. 


PREVIOUS (f5) Goes to the QUALIFICATIONS 
Menu. 


ROADMAP 







CHART DESIGN 
CONTROL MENU 


If you specify X (Axes) on the CHART 
DESIGN CONTROL Menu for a bar chart 
with a numeric X-axis variable, this 
menu comes up on your screen. It also 


QUALIFICATIONS MENU 
OR GRAPHING OPTIONS 


BAR CHART LEGENDS 
MENU (OR LABEL PROMPT 
MENU IF USED) 


ped 


NEXT (f6) If a P (Prompt) is entered 

in field 10 or 15, goes to LABEL PROMPT 
Menu. Otherwise, goes to BAR CHART 
LEGENDS Menu. 


DONE (f7) Goes to CHART DESIGN CONTROL 
Menu. 


HELP (f8) Initiates Help Facility, giv- 
ing an explanation of the BAR CHART AXES 
Menu (Numeric). 













PREVIOUS 


appears when you press PREVIOUS from the 
BAR LEGENDS Menu or LABEL PROMPT Menu 

if that menu was used, or NEXT from 
QUALIFICATIONS Menu or GRAPHING OPTIONS 
Menu if user labels are not used. 


Bar Chart Axes Menu (Textual) 


ac Chart Axe (Textual) 


Label type €N,F) 


Valid Label Types: 
| - Numeric (calculate) 


met for labels 


fo - Data contains labels 


Figure 5-10. 


Specifies the characteristics of both 
axes for a textual bar chart including: 
scaling, spacing and labeling of ticks, 
and grid lines. 


In a textual bar chart, the X-axis vari- 


able (usually plotted on the horizon- 


Bar label 


SSL ORT MANUAL 


type (N,P,D,W,M,,Y).. (i) 


Calendar label start 
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BAR CHART AXES (TEXTUAL) Menu 


tal axis) has been specified as textual 
(or left blank) on the BAR CHART Menu. 
If the X-axis variable is numeric, 
GRAPH uses the BAR AXES Menu (Numeric) 
instead. In either case, the Y-axis 
variables must be numeric. 


FIELD EXPLANATION 


dis 


Type 

The LZ that is entered in this 
field by default represents linear 
scaling. If you want logarithmic 
scaling instead, enter an 0. 
Logarithmic scaling may be useful 
if the data takes values over a 
very long range, or if you want to 
draw a linear plot of two variables 
that have an exponential rela- 
tionship. 


Minimum 

Enter the minimum value for the 
axis. If this field is left blank, 
DSG/3000 calculates the minimum 
from the data values. 


Max imum 

Enter the maximum value for the 
axis. The maximum value must be 
greater than the minimum value. If 
you do not enter anything 

here, DSG/3000 calculates the max- 
imum from the data values. For 
both numeric and textual Bar Chart 
axes, minimum and maximum cannot 
both be on one side of the 0 base 
line. 
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Interval Size 

Enter the number of units you want 
between major ticks in terms of the 
data. For example, if you want 
$100 between ticks, enter 100. If 
you do not fill this in, DSG/3000 
calculates the units between ticks 
from the data in such a way that 
there are approximately 5 intervals 
along the axis. If Type is 
logarithmic (0), this field rep- 
resents the number of powers of 10 
which will separate major tick 
marks. For example, a value of 1 
means that every power of 10 will 
have a tick mark. 


Number of Minor per Major Ticks 
Enter the number of minor tick 
marks between major ticks. Minor 
ticks are drawn smaller than major 
ticks and are not labeled. If you 
do not fill in this field, there 
will be no minor ticks. For 
logarithmic charts, a common number 
of minor per major ticks is 8. 
Lowering this number results in a 
less dense axis or chart. 


Draw Ticks on Right Axis 9. 
If you want the Y-axis ticks to be 

drawn on the right axis as well as 

the left one, enter any character 

in this field. (If you opted for 

horizontal bars on the BAR CHART 

Menu, entering a character here 

causes the ticks to be drawn on the 

upper axis as well as the lower 


axis.) 
10. 

Draw Grid Lines 
If you want grid lines to be drawn 
wherever there are major ticks, 
enter any character here. 
Draw Minor Grid Lines (Log scaling 
only) 
This field is ignored unless you 
have specified: 

log scaling (field 1) 

grid lines (field 7) it; 


number of minor per major ticks 
is >0 (field 5) 


If these conditions are satisfied 
and you type any character in this 
field, grid lines are drawn at mi- 
nor ticks as well as major ticks. 
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Number of Tick Marks per Label 

If you enter a 1 in this field (or 
leave it blank), every major tick 
will be labeled. Enter the number 
of major ticks per label. For ex- 
ample, if you want to label every 
other tick, enter a 2, which means 
that there will be two ticks per 
label. 


Label Type 

If you want the major ticks to be 
labeled according to the axis scal- 
ing, enter an N in this field. 
This is the default. If you want 
to supply your own labels which 
might be textual rather than nu- 
meric, enter a P; after you have 
pressed the ENTER for this menu, 
you can enter the labels on the 
LABEL PROMPT Menu. 


X-Axis Variable (Display only) 

The name of the independent var- 
iable is displayed here. It cannot 
be altered. 


12. 


13. 


14. 


Number of Bars 

If you do not fill in this field, 
DSG/3000 draws one bar for each 
data point. If you specify that 
you want a greater number of bars 
than there are data points, 
DSG/3000 leaves blank space for the 
remaining data values. If you spe- 
cify fewer bars than there are data 
points, DSG/3000 draws only as many 
bars as you request, starting from 
the beginning of the data file. 


Number of Bars Between Grid Lines 
If you do not fill in this field, 
no grid lines are drawn parallel to 
the bars. If you want grid lines to 
be drawn, enter the number of bars 
between grid lines. 


Bar Label Type 
Enter one of the following: 


N DSG/3000 calculates numeric 
labels from the axis scaling. 


D The data variable that you spe- 
cified as the X-axis variable in 
the BAR CHART Menu contains the 
bar labels. (Default) 
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P Use this option if you want to 
enter your own bar labels. Af- 
ter you have pressed ENTER and 
then NEXT, GRAPH issues the 
LABEL PROMPT Menu. (If you en- 
tered a P for both axes you 
will fill in the LABEL PROMPT 
Menu twice. ) 


For convenience, GRAPH allows you 
to specify the following time la- 
bels regardless of the values of 
the independent variable. Fields 
15 and 16 are used with time labels 
to give the starting point and 
length of the labels. 


W Weekdays. Each bar will be la- 
beled with a day of the week. 
If there are more than 7 bars, 
the labels will be repeated. 


M Months. Each bar will be 
labeled with the name of a 
month. If there are more than 
12 bars, the labels will be re- 
peated. 


Q Quarters. Each bar will be 
labeled with a quarter. If 
there are more than 4 bars, the 
labels will be repeated. 


Y Year. Each bar will be labeled 
with a year. 


15. Calendar Label Start (used only 
with time labels) 
Enter a number corresponding to the 
weekday, month, quarter, or year 
that labels the first (leftmost) 
bar. The default is 1, which cor- 
responds to MON for weekdays, JAN 
for months, QTR1 for quarters, or 1 
for year. For example, if you want 
the bars to be labeled by month be- 
ginning with November, type i7 in 
this field. If you want the bars 
to be labeled by years beginning 
with 1982, for example, type 1982 
in this field. 


16. Calendar Label Length (used for 
time labels only) 
A Abbreviated label form is 
printed on the graph. 
L Long form is printed on the 
graph. 


(default) 
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Abbreviated Long 
Weekdays MON MONDAY 
Months JAN JANUARY 
Quarters Q1 QTR1 
Years N/A 1982 
DISCUSSION 


The X-axis is labeled with the name of 
the x variable. 


If you do not fill in this menu, the 
axes characteristics take the following 
defaults: 

* linear axes 
* axes scaled according to the data 
values 
major ticks on Y-axis with numeric 
labels calculated from the scaling 
major ticks on X-axis with textual 
labels calculated from the data. 
no minor ticks or grid lines 


Note that calendar labels are blindly 
applied to tick marks, irrespective of 
the actual data. To avoid mislabeling, 
the X-axis interval size should be set 
to 1 in most cases. 


FUNCTION KEYS 

DRAW (f3) Draws the current chart. 
REFRESH (f4) Refreshes the screen by re- 
drawing it with the information entered 
as of the last ENTER. 

PREVIOUS (£5) Goes to QUALIFICATIONS 


Menu. 


ROADMAP 






CHART DESIGN 
CONTROL MENU 


If you are drawing a bar chart with a 
textual X-axis variable and you press 
X (axes) on the CHART DESIGN CONTROL 


QUALIFICATIONS 
MENU 


BAR CHART LEGONDS MENU 
(OR LABEL PROMPT IF USED) 
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NEXT (f6) If a P (Prompt) is entered 
in field 14, goes to LABEL PROMPT Menu. 
Otherwise, goes to BAR CHART LEGENDS 
Menu. 


DONE (f7) Goes to CHART DESIGN CONTROL 
Menu. 


HELP (f8) Initiates Help Facility, giv- 
ing an of the BAR CHART AXES Menu (Tex- 
tual). 






PREVIOUS 


Menu, this menu appears on your screen. 
You can also display it by pressing NEXT 
from QUALIFICATIONS or PREVIOUS from 

BAR CHART LEGENDS or LABEL PROMPT Menus. 


Bar Chart Legends Menu 


“ORAPH CAO) 00) Hae Char ee ee PMANUAL” 


Variable 


Refresh 





Figure 9-11. BAR CHART LEGENDS Menu 


Specifies color, texture, and legend FIELD EXPLANATION 
text for each bar variable in a bar 
chart. | 1. Variable (display only) 


Each of the Y-axis variables is 
displayed here. These names, taken 
from the BAR CHART Menu, cannot be 
altered on the BAR LEGENDS Menu. 
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Color 

This field only affects the chart if 
it is drawn on a multi-color plotter 
with multiple pens or color ter- 
minal. If nothing is entered in 
this field, the entire graph is 
drawn in black. If you want to as- 
sign a color to any of the bar var- 
iables, enter one of the following 
numbers next to the corresponding 
variable name: 


1 Black 
2 Red 

3 Green 
4 =Blue 
5...16 


This presumes that the pens 1-4 are 
inserted in the plotter in this or- 
der. (See Appendix A for inform- 
ation about color.) 


Texture 

If more than one Y-axis variable is 
being plotted, DSG/3000 assigns a 
different texture to each in the 
order shown in Appendix A. If you 
want to change the texture for any 
of the variables, enter one of the 
following numbers next to the 
corresponding variable name: 
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Legend Text 

For each Y-axis variable shown, 
GRAPH prints a legend showing each 
texture and the legend text shown 
in the last column. To change the 
legend text, enter the revised text 
here. This field can contain up to 
18 printable characters on each of 
2 lines. 


You can draw the graph without the 
legend by filling in the GRAPHING 
OPTIONS Menu appropriately. If your 
legend will only fill one line, use 
the lower for the best visual ef- 
fect. 


Celor 


(0-16) (0-2 Legend Text 


SUNTA 


gw «Refresh Previous Next _ 





Figure 5-12. BAR CHART LEGENDS Menu with Legend Text 


FUNCTION KEYS NEXT (f6) Goes to BAR AND LINE CHART 
TITLES Menu. 

DRAW (f3) Draws the current chart. 
DONE (f7) Goes to CHART DESIGN CONTROL 


REFRESH (f4) Refreshes the screen by re- Menu. 

drawing it with the information entered 

as of the last ENTER. HELP (f8) Initiates Help Facility, 
giving an explanation of the BAR CHART 

PREVIOUS (f5) Goes to BAR AXES Menu, or Menu. 


LABEL PROMPT Menu if it was used. 
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ROADMAP 





BAR CHART AXES MENU 
(OR LABEL PROMPT 
MENU IF USED) 


CHART DESIGN 
CONTROL MENU 
BAR AND LINE CHART 
TITLES MENU 


NEXT 





PREVIOUS 


If you are drawing a bar chart and from BAR AXES or LABEL PROMPT 
enter L (Legends) on the CHART Menus, or PREVIOUS from BAR AND 
DESIGN CONTROL Menu, this menu LINE CHART TITLES. 

appears. You can also press NEXT 
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Chart Browse Menu 
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CHART BROWSE Menu D 


Figure 5-13. 


FIELD EXPLANATION 


in 


bout all charts 
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Displays informat 


Lists the names of every chart in 
Charts are named or 


the chart file. 
renamed on the MAIN CONTROL Menu. 
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2. Type (Display Only) 
Gives the chart type as one of the 
following: Pie, Line, Bar or Slide. 
Chart type is specified on the CHART 
DESIGN CONTROL Menu. 


3. Comments (Display only) 
For each chart, displays optional 
comments that may have been entered 
on the CHART INFORMATION Menu. 


FUNCTION KEYS 
PRV PAGE (f1) Displays information about 


charts preceding those currently dis- 
played. 


ROADMAP 


MAIN CONTROL 
MENU 


NXT PAGE (f2) Displays information about 
charts following those currently dis- 
played. 


REFRESH (f4) Refreshes the screen by 
redrawing it with the information en- 
tered as of the last ENTER. 


PREVIOUS (f5) Goes to MAIN CONTROL 
Menu. 


NEXT (f6) Goes to MAIN CONTROL Menu. 
DONE (f7) Goes to MAIN CONTROL Menu. 
HELP (f8) Initiates Help Facility, 


giving an explanation of the CHART 
BROWSE Menu 





Entering a B on the MAIN CONTROL Menu 
brings this to your screen. 


Chart Design Control Menu 


--ENHANCEMENTS 
Axes scaling, ticks, grids 
Legends, colors, textures 
Titles 


Annotations 


Graphics device selection 
and control 


Initialize chart 





Figure 5-14. CHART DESIGN CONTROL Menu 


This menu branches to any one of the FIELD EXPLANATION 

design menus used to create or modify a 

chart. Required for all chart design. 1. Selection (Required) 
Must be one of the following let- 
ters: 


F Build/modify data file. Goes 
to DATA PROMPT Menu, which al- 
lows you to supply or alter the 
input data. 
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TI 


Data Definition. Goes to DATA A 
DEFINITION Menu, which allows 

you to name the data file and 

describe the variables. 

Data transformations. Goes to G 
DATA TRANSFORMATIONS Menu, 

which creates new variables 

mathematically from the ori- 

ginal variables. TC 
Specify chart type. Goes to 

either the PIE CHART, LINE 

CHART, BAR CHART, or ANNO- 

TATIONS Menu. If a pie, line 

or bar chart is being spe- 

cified, the data should already 

have been specified via the 

DATA DEFINITION Menu or DATA 

TRANSFORMATIONS Menu. FD 
Axes. Goes to the LINE CHART 

AXES or BAR CHART AXES Menu. 

Allows you to specify scaling, 

major and minor ticks, grids, 

and the label source. 

Legends. Goes to the appro- 

priate legends menu. You must 

have specified the chart type. 

Titles. Goes to the appro- 

priate titles menu. You must 

have specified the chart type. 
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Annotate chart. Goes to ANNO- 
TATIONS Menu, which allows you 
to draw boxes, lines, arrows, 
or text on the chart. 

Graphics device. Goes to the 
GRAPHING OPTIONS Menu, which 
allows you to route output to a 
plotter. 

Text control. Goes to the 
either the PIE TEXT CONTROL 
Menu or the BAR AND LINE TEXT 
CONTROL Menu, whichever is ap- 
propriate. Allows you to spec- 
ify font, size, and color for 
titles, subtitles, axis labels, 
legend labels, and footnotes 
but not annotations. 

Font Definition Goes to FONT 
DEFINITION Menu, which allows 
you to relate the four fonts 
available to font files as well 
as specify native languages for 
those fonts. 


Note: Only one hardware font is 
available and the font type de- 
pends on the device used. The 
native language characteristics 
of the font are established by 
the language specified for font 
1 on the FONT DEFINITION Menu. 


E Exit. Terminates GRAPH and re- 
turns you to MPE. 


2. Chart Type 
Must be one of the following let- 


P Pie chart 

L 4Line chart or scattergram 
B Bar chart 

S Slide (annotations only) 


When this menu first comes up on your 
terminal, this field contains an "S" be- 
cause the default chart-type is Slide 
only. To specify a different chart 
type, type a C in the first field, 

type over the S if you are changing 

the type, and press ENTER. 


This field has no effect on the chart 
type unless you have also entered a "C" 
(Specify chart type) to establish the 
current chart type. 


3. Initialize 
By typing any character in this 
field, you reset certain chart at- 
tributes to their default values. 
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For example, there are no titles, 
legends, annotations, subsets, and 
pie explosions. Data file inform- 
ation entered through the DATA 
PROMPT, DATA DEFINITION, and DATA 
TRANSFORMATIONS Menus remains 
unchanged. Initialize can be used 
to start over on a chart and still 
maintain the order of the charts in 
the chart file. This field is ig- 
nored unless you have also entered 
a "C" (Specify chart type) to 
establish the current chart type. 


DISCUSSION 


You pass through this menu at least 
twice when you are creating a chart: 
first to go to the DATA DEFINITION Menu 
(D), and then to go to the appropriate 
chart type menu (C). The menu functions 
as a transfer point between the 
different menus used in designing a 
chart, and several design menus return 
control to this menu after they have 
been completed. 


FUNCTION KEYS 
DRAW (f3) Draws the current chart. 
REFRESH (f4) Refreshes the menu by re- 


drawing it with the information entered 


as of the last ENTER. 


ROADMAP 


MAIN CONTROL 
MENU 


PREVIOUS (f5) Goes to the MAIN CONTROL 
Menu. 


DONE (f7) Returns to MAIN CONTROL Menu. 
HELP (f8) Initiates the Help Facility 


which gives an explanation of the CHART 
DESIGN CONTROL Menu. 


ADD MODIFY 





If you enter A or M on the MAIN 
CONTROL Menu, this menu appears on 
the screen. 
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Chart Information Menu 


Creator: MANAGER 





Figure 5-15. CHART INFORMATION Menu 


This menu displays information and FIELD EXPLANATION 
allows you to enter comments about the 
current chart. 1. Comments 


This field is optional. Enter any 
information you would like. The com- 
ments are also displayed when you 
browse the chart file by entering a 
B on the MAIN CONTROL Menu. 
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DISCUSSION 


When the CHART INFORMATION Menu comes up 
on your screen, the chart name, type, 
the date that it was created, and the 
name of the user and account in which it 
was created are displayed. The cursor 
is positioned in the "Comments" field so 
that you can enter any comment of up to 
45 characters in length which will help 
you to identify the chart. 


There is only one unprotected field in 


this menu. You cannot change the chart 
name, date, or creator. 


ROADMAP 


FUNCTION KEYS 


REFRESH (f4) Refreshes the screen by 
redrawing it with the information en- 
tered as of the last ENTER. 


PREVIOUS (f5) Returns to MAIN CONTROL 
Menu. 

NEXT (f6) Returns to MAIN CONTROL Menu. 
DONE (f7) Returns to MAIN CONTROL Menu. 
HELP (f8) Initiates the Help Facility, 


giving an explanation of the CHART 
INFORMATION Menu. 





MAIN CONTROL 
MENU 


To display this menu on your screen, 
enter an I on the MAIN CONTROL 
Menu. 
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Data Definition Menu 


Data types: N=Numeric, T=Text 


ceesspesanese 





Figure 5-16. DATA DEFINITION Menu 


Use this menu to specify the data file FIELD EXPLANATION 
and describe the variables within that 
data file. Required for all charts ex- 1. 


Data File Name (Required) 

Enter the name of the MPE file con- 
taining your data. The file name 
can be fully qualified: 


cept slides. 


filename[{ /lockword]{.group [ .account] ] 
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The file name can also be back- 
referenced with a formal designator 
preceded by an asterisk (*) if you 
have issued a :FILE command for 
your session. See the MPE Com 
ands Reference Manual for inform- 
ation about back-referencing files. 


Missing Data Value (Optional) 

You may have used a special data 
value in your data file to re- 
present data that was missing at 
the time the file was created. If 
you want DSG/3000 to ignore the 
missing data points rather than 
plotting them as value zero, enter 
the value of the missing data here. 
The missing data value must be num- 
eric. 


The default value is -9999. Blanks 
will be treated as 0. See Figures 
5-17 and 5-18 for an example of 
missing data. 


Variable Name (Required) 

Enter the name of each variable in 
the data file. Each variable must 
have a unique name. Variable names 
can be up to 16 characters long, 
beginning with a letter. The re- 
maining characters can be letters, 
numbers, hyphens (-) or under- 
lines (_). 
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You cannot use any of the following 
reserved words as variable names: 


ABS LN MOVEAVG 
AND LOG NOT 
CUMULATE MOD OR 

SQRT 


Data Type (Required) 

Each variable must be identified as 
numeric (N) or textual (T). If the 
variable contains only numbers with 
optional leading sign (+ or -), 
decimal point, or exponent (E), 
specify the data as numeric (N). 


For example, the following data 
values might be contained in a nu- 
meric variable: 


236.7 
325 
-99 
+2. 353 


where the last value is equal to 
2.3 * (10) **3. Any real data 
values are acceptable for numeric 
variables. (Note: negative sign (-) 
must precede the value.) 


If the data values contain alpha- 
betic characters, you must specify 
specify the data as textual (T). 


Data Format (Free): Field 

If the data file is in free format, 
you must fill in this field. Free 
format data is arranged in fields 
that are separated by commas or 


Data File Name: DEGT 


Missing Data Value:: 


Data types: N-Numeric, T=Text 


blanks. (See Section III for a 
full discussion of data formats.) 
For each variable, enter the number 
of the data field in which it 
occurs. Figure 5-17 shows a free 
format data file and the corres- 
ponding DATA DEFINITION Menu. The 
first field is field 1. 





Figure 5-17. Free Format Data File and 
DATA DEFINITION Menu 
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6a. Data Format (Fixed): Offset Figure 5-18 shows a fixed format 


If the data file is in fixed data file and the corresponding DATA 
format, you must fill in this DEFINITION Menu. 

field. Ina fixed format data 

file, each data field begins ina The variable MONTH has offset 0 be- 
particular column and has a fixed cause there are no characters be- 
length. Specify the offset for fore it in the data file; the var- 
each variable as the number of liable SALES has offset 3 because 
columns or characters from the be- there are 3 characters before it in 
ginning of the data record to the the data file. 


beginning of the data field. 


“GRAPH CAL01 00 Data Definition” 


Data File Name: DELIA 73 
Missing Data Value: -9999 
Data Format 


(Fixed) 
Variable Name Field Offset Length 


Data types: N-Numeric, T=Text 





Figure 5-18. Fixed-Format Data File and 
DATA DEFINITION Menu 
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6b. Data Format (Fixed): Length 
If the data file is in fixed format, 
you must specify the length in 
characters of the data field for 
each variable. In the above ex- 
ample, the variable MONTH is 3 
characters long and the variable 
SALES is 4 characters long. 


DISCUSSION 


If your data file was generated using 
the DATA PROMPT Menu, simply fill in the 
name of the file and press ENTER. GRAPH 
will fill in the variable names, data 
types, and data format for you. If your 
data file was created by any other 
method, you must fill in all the fields 
yourself. 


You can only plot values from one data 
file at a time. If you wish to use the 
same chart specifications to plot data 
from a different data file, go to the 
DATA DEFINITION Menu and type the name 
and variable description of the new file 
over the information for the old file. 
If the new data file has been generated 
by the DATA PROMPT Menu, the procedure 
to change data is even more simple. 
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Type the new data file name over the old 
one, fill in the Missing Data Value 
field, and press CLEAR DISPLAY to clear 
the rest of the menu following the cur- 
sor. When you press ENTER, GRAPH will 
fill in the variable descriptions for 
you. 


FUNCTION KEYS 

DRAW (f3) Draws the current chart. 
REFRESH (f4) Refreshes the screen by re- 
drawing it with the information entered 
as of the last ENTER. 

PREVIOUS (f5) Goes to DATA PROMPT Menu. 


NEXT (f6) Goes to DATA TRANSFORMATIONS 
Menu. 


DONE (f7) Goes to CHART DESIGN CONTROL 
Menu. 
HELP (f8) Initiates Help Facility, giv- 


ing an explanation of the DATA 
DEFINITION Menu. 


ROADMAP 





DATA PROMPT 
MENU 
CONTROL MENU ee 
DATA TRANSFORMATIONS 
MENU 









PREVIOUS 











If you enter a D on the CHART or PREVIOUS from DATA 
DESIGN CONTROL Menu, you bring this TRANSFORMATION Menu will also 
menu to the screen. Pressing display the menu. 


NEXT from the DATA PROMPT Menu 
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Type in the data file name, which 
can take the fcllowing form: 


File Name (Required) 
filename! /Lockword][ .group[ .account]] 


FIELD EXPLANATION 


is 


DATA PROMPT Menu 
D505 


Figure 5-19 
The file can 


each. 


data 
This menu allows you to construct a 
file to be graphed. 


Filenames and lockwords may each 
contain up to 8 alphanumeric char- 
acters, beginning with a letter. 


Filenames cannot contain any special 
characters or embedded blanks. If 
you are accessing a file that 
resides in a different group or 
account, you must supply 

their names also. See the MPE 
System Manager Reference Manual for 
more information on lockwords and 
security. 


Variable Name 

You must supply a name for every 
variable that you include in the 
data file. The variable name can 
be up to 8 characters beginning 
with a letter and consisting of 
letters, numbers, dashes (-), or 
underlines (_). 


Type 

For each variable in the data file, 
you must specify either an W for 
numeric or a Tf for textual (non- 
numeric). When you specify #, 

you must use only numeric values; 
specifying T allows you to use 
anything. 
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For example, Figure 5-19 shows a 
data file containing two variables. 
MONTH, containing letters, is a 
textual variable, and SALES, con- 
taining numbers, is a numeric var- 
iable. 


4. Data Values 
Fill in the values for each var- 
iable that you are creating in this 
menu. The values can each be up to 
12 characters long. This is the 
data that will actually be plotted 
on the graph. Remember that numeric 
variables can only have numbers as 
data values, as described in Type 
above. If any values are left 
blank, they are treated as missing 
data. Any signs (+,-) must be lead- 
ing. 


DISCUSSION 


Before you can produce a chart, you must 
create a data file by one of the 6 
methods outlined in Section III. If you 
intend to create a data file by entering 
the data interactively through GRAPH, 
you must fill out the DATA PROMPT Menu. 
Note that data files created through the 
DATA PROMPT Menu are not automatically 
associated with a particular chart. You 
must use the DATA DEFINITION Menu to as- 
sign a data file to a chart. 


If you are creating a new data file, en- 
ter the name of the file, the names of 
the variables, and the data values. If 
you want to read or modify the values in 
a file that already exists and was 
created with the DATA PROMPT Menu, type 
in the file name and press ENTER; GRAPH 
will fill in the rest of the menu for 
you if it is blank. 


In general, when you press ENTER, GRAPH 
will attempt to create and permanently 
save the data file as it appears on your 
screen. For example, if you have made 
changes or additions to an existing data 
file and press ENTER, GRAPH asks you to 
confirm that you want to write over the 
original contents of the file. If you 
again press ENTER, the new contents are 
saved and the previous contents are 
lost. If you press a function key, the 
original contents of the file remain un- 
altered. 
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If you wish to access a data file other 
than the one currently displayed by the 
DATA PROMPT Menu, type the name of the 
new file over the old one, press CLEAR 
DISPLAY to clear the rest of the 
display, and press ENTER. GRAPH will 
return the contents of the new data file 
to your screen. 


Remember that the DATA PROMPT Menu 
allows you to access only those files 
that were created using it. When you 
have finished creating your data file, 
press ENTER. When the cursor returns to 
the first field (File Name), you can 
press DONE (f7) to continue designing 
the graph. If you have already defined 
the data and designed the chart, you can 
draw the graph by pressing DRAW (f3). 


FUNCTION KEYS NEXT (f6) Goes to DATA DEFINITION Menu 
or MAIN CONTROL MENU, as applicable. 
DRAW (f3) Draws the current chart. 
DONE (f7) Goes to MAIN CONTROL Menu or 
REFRESH (f4) Refreshes the screen by re- CHART DESIGN CONTROL Menu, as appli- 
drawing it with the information entered cable. 
as of the last ENTER. 


HELP (£8) Initiates Help Facility, giv- 


PREVIOUS (f5) Goes to the MAIN CONTROL ing an explanation of the DATA PROMPT 
Menu or CHART DESIGN CONTROL Menu, as Menu. 
applicable. 


File name: DAT a Type: Nenumeric, T=text 


Variable 1 Variable 2 Variable 3 Variable 4 Variable & 
name type name type name type name y 





Figure 5-20. Completed DATA PROMPT Menu 
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ROADMAP 





MAIN CONTROL CHART DESIGN 
MENU CONTROL MENU 






DATA DEFINITION 
PREVIOUS MENU 


Entering F from the MAIN CONTROL or appear if you press PREVIOUS from the 
CHART DESIGN CONTROL Menus brings this DATA DEFINITION Menu. 
menu to the screen. It will also 
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Enter the names of the variables 
that you are creating. Each var- 
jable name can have up to 16 char- 
acters. Naming conventions are the 
same as for other variable names. 


FIELD EXPLANATION 
New Variable 


die 
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DATA TRANSFORMATIONS Menu 
iables 


e 


21. 
iables. 


lly trans- 


° 


ica 


Figure 5 
1 data var 


igina 


for graphing by mathemat 


Using this menu you create new var 
forming the or 


Mathematical Expression 


DISCUSSION 


Enter a mathematical expression us- 


ing variable names from the data 
file, and operators and functions 
Remember that 
the data variables used here must 
be previously defined in either the 
DATA DEFINITION Menu or the DATA 
(Table 5-3 
summarizes the operators that can 
be used in mathematical operators.) 


as defined below. 


TRANSFORMATIONS Menu. 


OPERATOR OR 
FUNCTION 


Add 

Subtract 
Multiply 
Divide 
Exponentiate 


Modulo (divide and save remainder) 


Common Logarithm (base 10) 


Natural logarithm (base e) 
Absolute Value 

Square Root 

Moving Average 
Cumulate (running sum) 


Table 5-3. 


data file. 


NOTATION 


%* 


MOD 


LOG (expression) 

LN (expression) 

ABS (expression) 
SORT (expression) 
MOVEAVG (variable,n) 
CUMULATE (variable) 


Operators and Functions Used 


in Data Transformations 
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This Menu allows you to name and define 
up to 10 new variables as mathematical 
expressions of the variables in your 

The data file variables must 
have been defined in the DATA DEFINITION 
Menu before being used in these 
mathematical expressions. 
define the new variables, you can 
specify them as variables to be plotted 
on the PIE CHART, BAR CHART, or LINE 
CHART Menus. 


After you 


EXAMPLE 


SALES + INVENTORY 
SALES - INVENTORY 
SALES * 12 

SALES / 12 
SALES**2 

YEAR MOD 100 


LOG (SALES + INVENTORY) 
LN (SALES + INVENTORY) 
ABS (SALES - INVENTORY) 
SORT (AREA * 9) 
MOVEAVG (SALES,3) 
CUMULATE (SALES) 


The operators and functions can operate 
on constants as well as variables. For 
example, 


TARGET=4 


Since transformations are processed in 
the order they are specified, you can 
use new variables within subsequent 
transformation expressions. For 
example: 


TOTAL=SALES+ INVENTORY 
MONTHTOTAL=TOTAL/12 


Here, SALES and INVENTORY have been 
defined as data variables, TOTAL is a 
new variable created as a a data trans- 
formation of SALES and INVENTORY, and 
MONTHTOTAL is a new variable defined in 
terms of TOTAL. 


Note: MOVEAGE and CUMULATE cannot be 
nested. 
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If data cannot be transformed or has il- 
legal results, the missing data value 
will be substituted for the result of 
the equation. 


You can use the operators and functions 
in any combination. Parentheses can be 
used to override the standard order of 
precedence: 


* functions and exponentiation 
performed from left to right 


* multiplication and division performed 
from left to right 


* addition and subtraction performed 
from left to right 


Examples 


ABS (PROFIT) /CUMULATE (SALES ) 
MOVEAVG (SALES+BACKLOG, 2) 


FUNCTION KEYS NEXT (f6) Goes to CHART DESIGN CONTROL 
Menu. 

DRAW (f3) Draws the current chart. 
DONE (f7) Goes to CHART DESIGN CONTROL 


REFRESH (f4) Refreshes the screen by re- Menu. 

drawing it with the information entered 

as of the last ENTER. HELP (f8) Initiates the Help Facility, 
giving an explanation of the DATA TRANS- 

PREVIOUS (f5) Goes to DATA DEFINITION FORMATION Menu. 

Menu. 

ROADMAP 





DATA DEFINITION 
MENU 
CHART DESIGN 
CONTROL MENU 









When you enter a T on the CHART Alternatively, you can press NEXT 
DESIGN CONTROL Menu, this menu comes from the DATA DEFINITION Menu. 
up on your screen. 
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Figure File Menu 


o Operation Figure(2) Figure File Name (3) 


A - Add figure ¢fill in the. following fields) 


(4) Comments: 


G) Chart (s) Chart File Name 





D - Delete figure 





Figure 5-22. FIGURE FILE Menu 


Using this menu, you create a figure FIELD EXPLANATION 
file for access by other subsystems. 
1. Operation 
A Add a figure to a figure file. 

If this is the first figure in a 
new figure file, you must create 
names for both the figure and the 
figure file. You need to fill in 
the chart or chart file names. 
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Chart and chart file names will 
already appear in the appropriate 
fields if you have filled them in 
on the MAIN CONTROL Menu. 


D Delete a figure from the figure 
file. This operation will not 
delete the figure file when you 
have deleted all figures within 
it. To delete the figure file, 
use the :PURGE command in MPE. 
(See the MPE Conmands Reference 
Manual for information on the 4. 
PURGE command. ) 


Figure 
Name of the figure you are storing. 
The name must be from 1 to 16 char- 5. 


acters in length beginning with a 

letter. Remaining characters can be 

letters, numbers or underbars (_). 

This field is required for creating 

the figure as well as accessing it 

from a subsystem. 6. 


Figure File Name 

Unique name of the file in which the 
figure is to reside. The figure 
file name is of the following form: 


filename! /Lockword][ .group[ .account] ] 
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The filename and the lockword can 
each contain up to 8 alphanumeric 
characters, beginning with a letter. 
They cannot contain any special 
characters or embedded blanks. If 
you are accessing a file that re- 
sides in a different group or ac- 
count, you must supply their names 
also. See the MPE System Manager 
Reference Manual for more inform- 
ation on lockwords and security. 


Comment associated with the figure 
Enter any comment you wish. Maximum 
length is 128 characters -- 64 char- 
acters per line. Optional entry. 


Chart 

Name of the current chart which you 
wish to have drawn to the figure 
file. It is automatically filled in 
from the MAIN CONTROL Menu. 


Chart File Name 

Name of the current chart file in 
which the chart you are drawing re- 
sides. It is automatically filled in 
from the Main Control Menu. 


DISCUSSION 


This menu allows you to draw the current 
chart from the current chartfile toa 
figure file. Figure files provide stor- 
age for complete figures. (See Section 
1 for a discussion of the use of figure 
files.) 


Figure files may be accessed from 
TDP/3000, HPDRAW and other Office System 
applications as well as the HP2680A 
(Laser Printer). Figure files can con- 
tain multiple figures. 
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see Appendix E for information about 
accessing figure files. 


FUNCTION KEYS 


REFRESH (f4) Refreshes the screen by re- 
drawing it with the information entered 
as of the last ENTER. 


DONE (f7) Goes to CHART DESIGN CONTROL 
Menu. 


HELP (f8) Initiates Help Facility, giv- 
ing an explanation of the FIGURE FILE 
Menu. 


ROADMAP 








MAIN CONTROL 
| MENU 


To bring this menu to your screen you must 
enter CF (Create Figure) on the MAIN 
CONTROL Menu. 
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Font Definition Menu 


font name and native language for each font number. 


Q) Language 


Languages: 


VSCLE CEnglish) 
Swedish / 
Norwegian / Danish 

- French 


Serman 
United kingdom 
Spanish 
Italian 


hey 





fa i | 


iis are available only for software text. 





Figure 5-23. FONT DEFINITION Menu 


With this menu you specify the font file FIELD EXPLANATION 
name and native language for each font 
used in the current chart. 1. Font Name 


Four fonts may be specified under 
font name. 
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The four fonts currently available 
are: 

Font 1. Stick (Simplex Roman) 
(STICK. VCHARSET.SYS) 
Script (Simplex Script) 
(SCRIPT. VCHARSET. SYS) 

Font 3. Roman (Triplex Roman) 
(ROMAN . VCHARSET .SYS) 
Gothic (Gothic English) 
(GOTHIC. VCHARSET. SYS) 


Font 2. 


Font 4. 


You need only enter a single font 
name in your specification-- Stick, 
Script, Roman, or Gothic-- following 
each of the Font Numbers. 


The fonts are set in the above or- 
der by default. Unless you enter 
different font names, leaving font 
1 blank will result in the Stick 
font appearing where font 1 is spe- 
cified, Script where font 2 is spe- 
cified, and so forth. 


Stick, Script, Roman and Gothic are 
generic names for the fonts. If you 
have a file called, for example, 
STICK, you would access it using MPE 
conventions: 


STICK. .mygroup.myaccount 
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2. Languages 


Enter the number of the selected 
language you wish to associate with 


the font file you have chosen. You 
have a choice of 7 languages. They 
are: 

1 USASCII (English) 

2 Swedish/Finnish 

3 Norwegian/Danish 

4 French 

5 German 

6 United Kingdom 

7 Spanish 


The default language (blank) will 
usually be USASCII. Currently the 
foreign languages are only available 
with the Stick font (software only). 


DISCUSSION 


This menu allows you to define the 
software fonts -- maximum of four per 
chart -- which you wish to use with the 
chart you are creating. It also allows 
you to associate the native language 
with each font you have specified. 


Only one hardware font is available and PREVIOUS (f5) Goes to PIE TEXT CONTROL 


the type of font depends upon the device or BAR AND LINE TEXT CONTROL Menu, dep 

being used. Usually, it is a Stick pending on the type of chart you are 

font. The native language char- drawing. 

acteristics of the single hardware font 

are mapped by the language number you NEXT (f6) Goes to CHART DESIGN CONTROL 

specify for Font Number 1 on this menu. Menu. 

(See the GRAPHING OPTIONS Menu for fur- 

ther information. ) DONE (f7) Goes to CHART DESIGN CONTROL 
Menu. 


FUNCTION KEYS 
HELP (f8) Initiates Help Facility, 
DRAW (f3) Draws the current chart. giving an explanation of the FONT DE- 
FINITION Menu. 
REFRESH (f4) Refreshes the screen by re- 
drawing it with the information entered 
as of the last ENTER. 












ROADMAP 
BAR OR LINE CHART 
TEXT CONTROL OR = 
PIE TEXT CONTROL 
CHART DESIGN 
CONTROL MENU 
If you enter FD from the CHART DESIGN NEXT from the BAR OR LINE CHART 
CONTROL Menu while creating a chart, TEXT CONTROL or PIE TEXT CONTROL Menus 
this menu comes to the screen. Pressing will also display it. 
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Graphing Options Menu 


Q) Device: 


» (3=Software, H=Hardware) 


Q) Plotting Area: 


Boundary type ......... fe 


Lower left 


Upper right 


(a) suppress Options: 


Titles 
Legends 
Chart Advancement 





Figure 5-24. 


Use this menu to specify plotting device 
and the device's characteristics, number 
of copies, plotting area, and elements 
to be suppressed when the chart is 
drawn. 
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HP-IB Address 


(F=Fast, S=Slow, T=Transparency) 


c, DsData, C=Chart) 


millimeters) 
millimeters) 


GRAPHING OPTIONS Menu 


FIELD EXPLANATION 


1. Device 
If you are running GRAPH from a 
graphics terminal this field is 
filled in with the terminal as the 
default plotting device. 


A) ID B) 
The model of the plotting 
device. Must be one 
of the following: 
Terminals 264U7A 26238 
264U7F 26488 
2703 
Tywo-color TU70A 
Plotter Opt. 001 (RS-232-C) 
002 (HP-IB) 
Four-Color 7220A/S 72214/B/S 
Plotters 9872A/B/S 
Eight-Color 7220C/T 7221C/T 
Plotters 7580A 
Opt. 001 (RS-232-C) C) 
002 (HP-IB) 
7585 
9872eCc/T 
Thermal Plotter 7240A 7T245A/B 


Printer 


Mini-Plotter 


Laser Printer 


7225A/B (17601A,17603A, 
176044) 


2680A 


Note that the 7220S/T, the 
7221S/T, and the 9872S/T use 
scrollable paper. If you are 
using one of these plotters 
without scrollable paper, you 
should designate the ID as 
7220A/C, 7221A/C, or 9872A/C. 
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HP-IB Address 

If the plotting device is a 
9872A/B/C/S/T, 7225A using the 
1706A module, 7245A/B, 7470A 
(Opt.002), or 7580A Opt. 002, 
the HP-IB address set on the 
back of the device must be 
supplied. The default address 
on these devices is 5. If this 
field is blank when the device 
is a 9872A/B/C/S/T or a 7245A/B, 
GRAPH will supply an address of 
5. If this field is blank and 
the device is a 7225A, T7H70A, or 
7580A, the field is left blank 
and non-HP-IB addressing is 
assumed. 


speed 

This field refers to plotters 

only. Enter one of the follow- 

ing: 

F Fast speed, appropriate for 
drawing on paper. (default) 

S Slow speed, should be used 
when drawing on 
transparencies. 

T Transparencies with 15 minute 
pauses between pen changes. 
(This assures that colors 
will have time to dry. The 
length of the pauses can be 
changed by the system 
manager. ) 


Note: For the 7580 and 7470, 
fast speed is set by pen 
carousel as is pen force. 


D) 


E) 


Copies 

Enter the number of copies of 
this chart to be drawn, from 1 
to 99. This feature is useful 
for producing multiple copies of 
charts on scrollable plotters 
with automatic paper advance. 
Note that from the MAIN CONTROL 
Menu you can draw the whole 
chart file with pauses between 
charts for reloading non- 
scrollable plotters; you will 
get as many copies of each chart 
as you have specified on the 
GRAPHING OPTIONS Menu for that 
chart. 


The default is one copy. 


Text 
Enter one of the following: 


Ss Software. Text is scaled 
precisely by software. 


H Hardware. Text is scaled 


and drawn much faster by 
hardware. 


a-T1 


On plotters, software and hard- 
ware characters will be the same 
size. On terminals, hardware 
characters are larger and more 
legible than the software char- 
acters, but software characters 
show the correct proportion for 
hardcopy devices. Hardware 
characters on terminals may 
cause titles and footnotes to be 
truncated or written beyond the 
frame boundaries. Also, since 
hardware characters on terminals 
do not shrink, labels may over- 
lay each other if the plotting 
area shrinks. If character size 
is a problem, use software char- 
acters. 


Only one hardware font is avail- 
able. The type is determined by 
the device used. Usually, it is 
the Stick font. The native 
language characteristics of the 
hardware font will be determined 
by the native language specified 
for Font 1 on the FONT 
DEFINITION Menu. 


2. Plotting Area 
On plotters, this is usually 8-1/2 


inch by 11 inch horizontal format by 


default. To change the boundaries, 
give the coordinates for either the 


data (actual plotting area) or chart 


(including titles and footnote 
area). When the 7580 is used, the 
default is a D-size sheet of paper. 


A) Boundary Type 
Specify one of the following: 


D Data boundary. This 
coincides with the axes on a 
line or bar chart. It may 


not be used for pie charts or 


slides. Data boundaries 
include areas required for 
legend text. 


C Chart boundary. Coincides 
with the frame that can be 


drawn around the entire chart 


area, including titles and 
footnotes. 


For pie charts, DSG/3000 may 
adjust the specified chart 
boundaries to ensure a pie 
chart of correct proportions. 


a=t2 


E English standard. The entire 
charts fits on an area 
approximately 8-1/2 inch by 
11 inch in size. This is the 
default value. The upper 
right and lower left fields 
are ignored for all devices 
except the 7580A. 


M Metric standard. The entire 
chart fits on an area 
approximately 210mm by 298mm 
in size. The upper right and 
lower left fields are 
ignored. 


B) Lower Left 


Give coordinates (X,Y) of the 
lower left corner in milli- 
meters. The x-coordinate (hori- 
zontal) is given first. 


C) Upper Right 


Give coordinates (K,Y) of the 
upper right corner in milli- 
meters. The x-coordinate (hori- 
zontal) is given first. 


Example 


To draw a chart in the upper right 
hand quarter of an 11 inch x 17 
inch (HP9280-0180) sheet of paper, 
specify the following Chart Bound- 
ary: 


Lower Left: .citaese es 200,140 
Upper Right ......... 400,270 


CHART BOUNDARY 


1979 SALES 
QUOTA—SALES ACTUAL—SALES 


DOLLARS 


NOV f DEC 


DATA BOUNDARY 





Figure 5-25. Chart and Data Boundaries 


3. Suppress Options Titles Anything entered on the 
If you want to suppress any of the PIE TITLES Menu or BAR 
chart attributes so that they will AND LINE CHART TITLES 
not be drawn with the rest of the Menu is suppressed. This 
chart, type any character in the includes main title, sub- 
highlighted field to the left of the title, footnotes, and 
appropriate option(s): axis titles. 
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Labels 


Axes 


Legends 


Data 


Frame 


Chart 
Advance 


The labels on major 
ticks, bars, or pie seg- 
ments are suppressed. 


The axes, including ticks 
and grid lines, are not 
drawn. 


The legends that are us- 
ually drawn on the top or 
side of bar and line 
charts are suppressed. 


The actual bars or lines 
are not drawn on the 
chart. For pie charts, 
the pie circles and seg- 
ments are not drawn. 


The frame is the box that 
encloses the whole graph 
including titles and 
footnotes. It is sup- 
pressed by default. 
(Blank out this field if 
you want the frame to be 
drawn. ) 


For scrollable plotters, 
the paper is not 
advanced; for graphics 
terminals, the graphics 
screen is not cleared. 
In either case, the 
current graph is drawn 
over the previous graph. 


5-74 


DISCUSSION 


If you are using a supported HP graphics 
terminal, the terminal is the default 
plotting device and is listed as such 
when the GRAPHING OPTIONS Menu first 
comes up on your screen. If the device 
specified for the chart is another 
graphics terminal, the current graphics 
terminal will be used automatically. To 
redirect output, or to assign a plotting 
device from a non-graphics terminal, 
enter the appropriate device 
identification number; for the HP-IB 
devices you must also specify the HP-IB 
address. 


If you do not specify the plotting area, 
DSG/3000 will scale the graph to fit 
your terminal screen, or to approximate 
an 8-1/2 inch x 11 inch page if the out- 
put device is a plotter. To override 
the size and placement, specify the 
plotting area in millimeters. Note that 
these menu specifications override any 
limit points that were set on the 
plotter itself with plotter keys P1 (or 
lower left) and P2 (or upper right). 

The specifications entered on the menu 
have the advantage of being stored with 
the chart, unlike the plotter limit 
points. 


Any of the chart attributes listed below 
may be suppressed (not drawn) when the 
graph is drawn: 


titles 

legends 

labels 

data (lines or bars) 

axes 

frame (suppressed by default) 
advance paper (or clear video dis- 
play) 


* * *£ ee & * 


If the output device is a scrollable 
plotter, suppressing the chart advance 
results in the current chart overlaying 
the one previously drawn. If the output 
device is a graphics terminal, the 
graphics display is not cleared before 
drawing the current chart, which also 
results in overlayed graphs. 


a2 


If it is necessary to terminate plotting 
before it is completed, use <Control Y> 
rather than shutting off the plotter. 
This is done by pressing the Y key while 
the CNIL key is held down. It may be 
necessary to press the Y key more than 
once before control returns. Note that 
plotting may continue although control 
returns because of storage areas within 
the plotter itself. 


FUNCTION KEYS 
DRAW (f3) Draws the current chart. 
PREVIOUS (f5) Goes to ANNOTATIONS MENU. 


NEXT (f6) Goes to TEXT CONTROL MENU for 
the chart type you are designing. 


DONE (f7) Goes to CHART DESIGN CONTROL 
Menu. 


HELP (f8) Initiates Help Facility, giv- 
ing an explanation of the GRAPHING 
OPTIONS Menu. 


ROADMAP 





TEXT 
CONTROL MENU 


When you enter a G on the CHART DESIGN NEXT from the ANNOTATIONS Menu or 
CONTROL Menu, this menu comes up on your PREVIOUS from the TEXT CONTROL Menus. 
screen. Alternatively, you can press 


PREVIOUS 
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Label Prompt Menu 


Label: Y AXIS 


SOR ie ad eo 


Dae) 


ed 


a ae a ar 
CP ta Pace 


ram 





Figure 5-26. LABEL PROMPT Menu 


Provides labels for bars on bar chart or 
or major ticks on either a bar or line 
chart. If this menu is used, the labels 
entered here override any labels con- 
tained in the data. 


2-TT 


FIELD EXPLANATION 


i 


Labels 

Enter the labels as they correspond 
with the bars or major ticks along 
the axis. The first bar or tick is 
on the left (horizontal axis) or on 
the bottom (vertical axis). 


Remember that the labels will repeat 
themselves if you enter fewer labels 
than bars or ticks. 


DISCUSSION 


When the LABEL PROMPT Menu comes up on 
your screen, the axis being labeled is 
identified as Y-axis or X-axis. If you 
want to supply labels for both axes, 
fill in the labels for the first axis, 
press ENTER, press NEXT (f6), fill in 
the labels for the second axis, and 
press ENTER again. Pressing NEXT one 
more time will bring you to a legends 
menu, while pressing PREVIOUS brings you 
back to the first LABEL PROMPT Menu. 


The labels that you enter in this menu 
are stored in circular buffers. This 
means that if you enter fewer labels 
than there are ticks or bars along the 
axis, the labels are repeated in order 
until all of the ticks or bars are 
labeled. 


The labels entered on this menu can be 
suppressed when the chart is actually 
drawn by filling in the GRAPHING OPTIONS 
Menu appropriately. 
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FUNCTION KEYS 
DRAW (f3) Draws the current chart. 


REFRESH (f4) Refreshes the screen by re- 
drawing it with the information entered 
as of the last ENTER. 


PREVIOUS (f5) Goes to the appropriate 

axes definition menu: LINE CHART AXES, 
BAR CHART AXES (NUMERIC), or BAR CHART 
AXES (TEXTUAL). 


NEXT (f6) If you requested to be 
prompted for labeling both axes, this 
menu is repeated. Otherwise, goes 

to LINE LEGENDS or BAR CHART LEGENDS 
Menu. 


DONE (f7) Goes to CHART DESIGN CONTROL 
Menu. 


HELP (f8) Initiates Help Facility, 
giving an explanation of the LABEL 
PROMPT Menu. 


ROADMAP 





AXES MENU 
(LINE OR BAR) 
NEXT 
CHART DESIGN LEGENDS MENU 
CONTROL MENU (LINE OR BAR) 


PREVIOUS 
PROMPT (P) 












To display this menu you must enter 


press NEXT, or press PREVIOUS from a 
P for label type from the LINE AXES or legends menu. 
BAR AXES (NUMERIC or TEXTUAL) Menus and 


O19 


Line Chart Menu 


Variable 


: 2 > Sceattergram 


ro) 


Data Subset Specification: Coptional) 





Draw Refresh. Previous Next Done Help 





Figure 5-27. LINE CHART Menu 


This menu names the variables to be FIELD EXPLANATION 

plotted, selects a subset of the data, 

and specifies the scattergram option. 1. Y Axis Variables (Required) 
Required for line charts and Fill in the names of the Y-axis 
scattergrams. variables exactly as they appear in 


the DATA DEFINITION Menu or DATA 
TRANSFORMATIONS Menu. You must spe- 
cify at least one and no more than 
8 variables in this field. 
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X Axis Variable 

Fill in the name of the independent 
variable that will be plotted along 
the X-axis. Like the Y-axis var- 
iables, this variable name must also 
be defined in the DATA DEFINITION or 
DATA TRANSFORMATIONS Menus. If you 
do not fill in this field, GRAPH 
supplies an X-axis variable with 
values 1,2,3, and so forth, up to 
the number of data points taken by 
the Y-axis variables. 


Options: Scattergrams 

Enter any letter in this field if 
you wish to produce a scattergram 
instead of a line chart. A scatter- 
gram plots data points without con- 
necting lines and without sorting 
the X-axis variable. 


Data Subset Specification 

If you want to graph a subset of the 
data file, enter a subset specifica- 
tion expression. In general, the 
expression has the form: 


DEPT=SALES OR EXPENSES>800 


is a subset expression where DEPT 
and EXPENSES are names of variables 
in the data file. The variables 
used to specify the subset are not 
necessarily those being graphed. 


Parentheses can be used to override the 
standard order of precedence: 


1. Relational operators processed from 
left to right. 

2. NOT processed from left to right. 

4 AND and OR processed from left to 
right. 


If you are stating the expression in 
terms of a textual variable whose 

value contains embedded blanks, use 
quotation marks or apostrophes around 
the value. Use quotation marks around a 
value with an embedded apostrophe; like- 
wise, use apostrophes around a value 
with embedded quotation marks. 


Examples 


variablename relop value 
sea ea variablename relop value [...]] DEPT="R$D" NAME='"X"' 
OR POSITION="BOSS'S SON" 
where relop is a relational opera- 


tor from Table 5-4. For example, 
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Table 5-4. Relational Operators for 
Subset Expressions 





Equals 

Not equal 

Greater than 

Greater than or equal to 
Less than 

Less than or equal to 








DISCUSSION 


All line chart variables must contain 
numeric data and must be specified as 
numeric in the DATA DEFINITION Menu. 
There is only one X-axis variable 
plotted along the Y-axis, but there can 
be up to 8 Y-axis variables plotted 
along the X-axis. Each Y-axis variable 
corresponds to a line on the line chart. 
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Functions Keys 
DRAW (f3) Draws the current chart. 


REFRESH (f4) Refreshes the screen by 
redrawing it with the information 
entered as of the last ENTER. 


PREVIOUS (f5) Goes to CHART DESIGN CONTROL 
Menu. 


NEXT (f6) Goes to QUALIFICATIONS Menu. 


DONE (f7) Goes to CHART DESIGN CONTROL 
Menu. 


HELP (f8) Initiates Help Facility, giving 
explanation of the LINE CHART Menu. 


ROADMAP 





CHART DESIGN 

CONTROL MENU 

QUALIFICATIONS 
MENU 












PREVIOUS 





You can bring this menu to your screen VIOUS from the QUALIFICATIONS menu if 
by entering C and Z on the CHART DE- you are designing a line chart. 
SIGN CONTROL Menu or by pressing PRE- 
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Line Chart Axes Menu 


A Axis Variable = 


per major tick 


1 right? top axi 


raw gric ilies 


Draw minar grid lines Clogs only) .... 


Number of tick marks per label 
ESHEL TYDO: ea cccer ae Sake eae 


H - Numeric (calculate) Wo- Weekdays (1-7) 
P - Prompt for labels Mo- Months (1-12) 





G - Guart 
¥ - Years 


Figure 5-28. LINE CHART AXES Menu 


Use this menu to specify the character- 
istics of the X- and Y-axes for a line 
chart menu, including: axis type, scal- 
ing, spacing and labeling of ticks, and 
grid lines. 
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FIELD EXPLANATION 


l. 


Type 

The LZ that is entered in this 
field by default represents linear 
scaling. If you want logarithmic 
scaling instead, enter an O. 


Logarithmic scaling may be useful if 5; 
the data takes values over a very 

large range, or if you want to draw 

a linear plot of two variables that 

have an exponential relationship. 


Minimum 

Enter the minimum value for the 
axis. If this field is left blank, 
DSG/3000 calculates the minimum from 
the data values. 


Maximum 6. 
Enter the maximum value for the 

axis. The maximum value must be 

greater than the minimum value. If 

you do not enter anything here, 

DSG/3000 calculates the maximum from 

the data values. ie 


Interval Size 

Enter the number of units you want 

between major ticks in terms of the 

data. For example, if you want $100 8. 
between ticks, enter 100. If you 

do not fill this in, DSG/3000 

calculates the units between ticks 

from the data in such a way that 

there are approximately 5 intervals 

along the axis. If Type is 

logarithmic, this field represents 

the number of powers of 10 which 
will separate major tick marks. 
example, a value of 1 means that 
every power of 10 will have a tick 
mark. 


For 
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Number of Minor per Major Ticks 
Enter the number of minor tick marks 
between major ticks. Minor ticks 
are drawn smaller than major ticks 
and are not labeled. If you do not 
fill in this field, there will be no 
minor ticks. For logarithmic charts, 
a common number of minor per major 
ticks is 8. Lowering this number 
results in a less dense axis or 
chart. 


Draw Ticks on Right/Top Axis 

If you want the Y-axis ticks to be 
drawn on the right axis as well as 
the left one, enter any character in 
this field. 


Draw Grid Lines 

If you want grid lines to be drawn 
wherever there are major tick marks, 
enter any character in this field. 


Draw Minor Grid Lines (Log scaling 
only) 

This field is ignored unless you 
have specified: 


log scaling (field 1) 
grid lines (field 7) 
number minor ticks is >0 (field 5) 


10. 


11. 


If these conditions are satisfied 
and you type any character in this 
field, grid lines are drawn at minor 
ticks as well as major ticks. 


Number of Tick Marks per Label 

If you enter a 1 in this field (or 
leave it blank) every major tick 
will be labeled. Enter the number 
of major ticks per label. For 
example, if you want to label every 
other tick, enter a 2, which means 
that there will be 2 ticks per 
label. 


Label Type 

If you want the major ticks to be 
labeled according to the axis scal- 
ing, enter an W in this field. 

This is also the default. If you 
want to supply your own labels which 
might be textual rather than 
numeric, enter a P; after you have 
pressed ENTER from this menu, you 
can enter the labels on the LABEL 
PROMPT Menu. 


Type 


Same as field 1, but refers to the 
X-axis. 
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12. 


13. 


1h. 


15. 


16. 


17. 


18. 


19.3 


Minimum 
Same as 
X-axis. 


field 2, but refers to the 


Maximum 
Same as 
X-axis. 


field 3, but refers to the 


Interval Size 
Same as field 4, but refers to the 
X-axis. 


Number of Minor per Major Ticks 
Same as field 5, but refers to the 
X-axis. 


Draw Ticks on Right/Top Axis also 

If you want the X-axis ticks to be 
drawn on the top axis as well as the 
bottom one, enter any character in 
this field. 


Draw Grid Lines 


Same as field 7, but refers to the 
X-axis. 


Draw Minor Grid Lines 
Same as field 8, but refers to the 
X-axis. 


Number of Tick Marks per Label 
Same as field 9, but refers to the 
X-axis. 


20. Label Type 
Enter one of the following: 


N DSG/3000 calculates numeric 
labels from the axis scaling. 
(Default) 

P Use this option if you want to 

. enter your own tick labels, which 
might be textual rather than nu- 
meric. After you have pressed EN- 
TER and then NEXT, GRAPH issues 
the LABEL PROMPT Menu. (If you 
entered a P for both axes, you 
will fill in the LABEL PROMPT 


Menu twice.) 21. 


For convenience, GRAPH allows you to 
specify the following time labels 
regardless of the values of the 
X-axis variables. Fields 21 and 22 
are used with time labels to give 
the starting point and length of the 
labels. 


W Weekdays. Each major tick will be 
labeled with a day of the week. 
If there are more than 7 tick 
marks, the labels will be re- 
peated. 
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M Months. Each major tick will be 
labeled with the name of a month. 
If there are more than 12 tick 
marks, the labels will be re- 
peated. 


Q Quarters. Each major tick will be 
labeled with a quarter. If there 
are more than 4 tick marks, the 
labels will be repeated. 


Y Year. Each major tick will be 
labeled with a year. 


Calendar Label Start (used only with 
time labels) Enter a number cor- 
responding to the weekday, month, 
quarter, or year that labels the 
first (left -most) tick mark. The 
default is 1, which corresponds to 
MON for weekdays, JAN for months, 
QTR1 for quarters, or 1 for year. 
For example, if you want the ticks 
to be labeled by month beginning 
with November, type 11 in this 
field. If you want the ticks to be 
labeled by years beginning with 
1982, for example, type 1982 in 
this field. 


22. Calendar Label Length (used for time 


labels only) 


A Abbreviated label form is printed 


on the graph. (Default) 


L Long form is printed on the 


graph. 
Abbreviated Long 
Weekdays M MON 
Months J JAN 
Quarters Ql QTR1 
Year 82 1982 
DISCUSSION 


This menu consists of two columns of 
fields. The first column (fields 1-10) 
refers to the Y-axis. 
(fields 11-20) refers to the X-axis. 
The name of the X-axis variable appears 
in the upper left hand corner of the 
screen. 


If you do not fill in this menu, the 
axes characteristics take the following 
defaults: 


* linear axes 

* axes scaled according to the data 
values 

* major ticks with numeric labels cal- 
culated from the data. Y-axis is 
labeled from data; X-axis is labeled 
with 1,2,3, etc. 

* 


no minor ticks or grid lines 


The second column 
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Note that calendar labels are blindly 
applied to tick marks, irrespective of 
the actual data. To avoid mislabeling, 
the X-axis interval size should be set 
to 1 in most cases. 


FUNCTION KEYS 
DRAW (f3) Draws the current chart. 


REFRESH (f4) Refreshes the screen by 
redrawing it with the information 
entered as of the last ENTER. 


PREVIOUS (f5) Goes to QUALIFICATIONS 
Menu. 


NEXT (f6) If a P (Prompt) is entered 
in field 7 or 10, goes to LABEL PROMPT 
Menu. Otherwise, goes to LINE CHART 
LEGENDS Menu. 


DONE (f7) Goes to CHART DESIGN CONTROL 
Menu. 


HELP (f8) Initiates Help Facility, 
giving an explanation of the LINE CHART 
AXES Menu. 


ROADMAP 
QUALIFICATIONS 
MENU 
CHART DESIGN 
CONTROL MENU 


LINE CHART LEGENDS 
MENU (OR LABEL PROMPT 
MENU IF USED) 













PREVIOUS 





Press X from the CHART DESIGN CONTROL QUALIFICATIONS Menu or PREVIOUS from the 
Menu while designing a line chart and LABEL PROMPT Menu, if it was used, or 
this menu comes to your screen. You can the LINE CHART LEGENDS Menu. 


also reach it by pressing NEXT from the 
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Line Chart Legends Menu 


Color Marker Texture 
(0-3) Legend Text 





Figure 5-29. LINE CHART LEGENDS Menu 


This menu specifies colors, markers, FIELD EXPLANATION 
textures, and legend text for each line 
of a line chart. 1. Variable (display only) 


Each of the Y-axis variables is dis- 
played here. These names, taken from 
the LINE CHART Menu, cannot be al- 
tered on the LINE CHART LEGENDS 
Menu. 
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Color 

This field only affects a graph when 
it is drawn on a plotter with mul- 
tiple pens. If you do not enter 
anything is this field, all of the 
lines in the line chart will be 
drawn in black. If you would like 
to assign colors to any of the lines 
in the graph, enter one of the fol- 
lowing numbers next to the corres- 
ponding variable name: 


1. Black 
2. Red 
3. Green 
4h. Blue 
5...16 


This presumes that the pens 1-4 are 
inserted in the plotter in this or- 
der. (See Appendix A for in- 
formation about colors.) 


Marker 

If you do not enter anything in this 
field, no data markers are drawn on 
the graph unless the scattergram 
option has been specified. If you 
want to assign data markers for each 
of the data values taken by a 
particular variable, enter one of 
the following numbers next to the 
corresponding variable name: 
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See Figure 5-30B for an 


= none 


on & oO 
1 | 
4 ®O0O°O 


I 
ob + 


illustration of 


data markers. 


4, 


Texture 

If you do not enter anything in this 
field, each of the plotted lines is 
draw with a different texture. The 
order of assignment of textures is 
shown in Appendix A. To change the 
texture of any of the lines, enter 
one of the following numbers next to 
the corresponding variable name: 





5 — wee ee — 
1 6 anneaeeanae 
2 ————— Peete eed 
2S B vecccccccccccce . 
4 ——-—-— 


Legend Text 

If you do not enter anything in this 
field, a legend is drawn on the 
graph identifying each line texture 
with the corresponding variable name 
from field 1. If you choose to 


Variable 


modify the legend text for any of 
the variables, enter the new legend 
text here. The default size of 
legend text is 5. See Appendix A for 
examples of sizes. 





Figure 30a. LINE CHART LEGENDS Menu 
with Legend Text Entered 
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ACME MANUFACTURING INCORPORATED 


LEGEND TEXT 


TOTAL SALES TOTAL EXPENSES WESTERN SALES EASTERN SALES 
ha 


MILLIONS OF DOLLARS 


DATA MARKERS— 





Figure 5-30b. LINE CHARTS Graph 
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NEXT (f6) Goes to BAR AND LINE CHART 


FUNCTION KEYS TITLES Menu. 

DRAW (f3) Draws the current chart. DONE (f7) Goes to CHART DESIGN CONTROL 
Menu. 

REFRESH (f4) Refreshes the screen by re- 

drawing it with the information entered HELP (f8) Initiates Help Facility, giv- 

as of the last ENTER. ing an explanation of the LINE CHART 


LEGENDS Menu. 
PREVIOUS (f5) Goes to LINE CHART AXES 
Menu or LABEL PROMPT, if used. 





















ROADMAP 
LINE CHART AXES MENU 
(OR LABEL PROMPT NEXT 
IF USED) 
CHART DESIGN 
CONTROL MENU 
BAR AND LINE CHART PREVIOUS 
TITLES MEMU 
This menu comes to your screen when you AXES Menu or LABEL PROMPT, if used, or 
enter an Z on the CHART DESIGN CONTROL PREVIOUS from BAR AND LINE CHART TITLES 
Menu while designing a line chart. You Menu. 


can also press NEXT from the LINE CHART 


5-94 


Main Control Menu 


Operation Chart Name Chart File Hame 


Add new chart G3) 


Modify or recall chart 


Purge chart f Build/modify data fil 


Display/supply chart information C Create figure file 


Draw chart(s): Or p- Noy Exit 


Device ID 4 sisasiieweae oe 
HP-IB # 


Copy chart from: 
Chart name ........ee eee 
Chart files. ss 





Figure 5-31. MAIN CONTROL Menu 


The MAIN Menu provides entry to all FIELD EXPLANATION 
GRAPH utilities and functions. You must 
complete this menu before going on to 1. Operations (Required) 


other screens. Must be one of the letters listed 


on the next page. 
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Add new chart. Used to design a 
new chart. You must also enter a 
chart name and chart file name. 
Control is then transferred to 
the CHART DESIGN CONTROL Menu. 


Modify chart. Used to review or 
alter the characteristics of an 
existing chart. You must also 
enter a chart name and chart file 
name. Control is then trans- 
ferred to the CHART DESIGN CON- 
TROL Menu. 


Purge Chart. Permanently elim- 
inates the chart from the chart 
file. You must also enter the 
chart name and chart file name. 


Chart information. Goes to CHART 
INFORMATION Menu. You must also 
enter a chart name and chart file 
name. 


Draw chart or chart file. If you 
enter the chart file name without 
a specific chart name, all of the 
charts in the file will be drawn. 
If you name a chart as well as 

the chart file name, only that 
particular chart is drawn. (See 
Step 4 for discussion of drawing. ) 
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Copy chart. Makes a copy of an 
existing chart. Can be used to 
change a chart name. Enter the 
existing chart and chart file 
name in fields 7 and 8, and enter 
the new chart and chart file name 
in fields 2 and 3. If you do not 
fill in the name of the existing 
file (field 8), it is 

assumed to be the same as the new 
file (field 3). The new chart 
file is created at this time if 
it does not exist. 


Browse chart file. Used to dis- 
play the name and type of each of 
the charts in the file along with 
comments, if any. You must also 
enter a chart file name in field 


3 


QUERY.PUB.SYS. Used to exit 
GRAPH and enter the QUERY/3000 
subsystem. When you exit Query, 
you will be returned to the MAIN 
CONTROL Menu. 


Build or modify data file. Goes 
to DATA PROMPT Menu. 


CF Create Figure File 


Goes to FIGURE FILE Menu, which 
enables you to store figure in- 
formation for access by other 
subsystems and certain 
intelligent devices. 
E Exit. Used to terminate GRAPH. 
Chart Name 
Type in the chart name, which must 
be 1 to 16 characters in length be- 
ginning with a letter. Remaining 
characters can be letters, numbers 
er underscores(_). The chart name 
must be unique within the chart 
file. This field is required for 
adding, modifying, purging, dis- 
playing chart information, copying a 
chart, or drawing a specific chart 
in the chart file. 


Chart File Name 

Required unless building or 
modifying a data file or exiting 
from GRAPH. The chart file name is 
of the following form. 


filename[ /Lockword][ .group[ .account]] 
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where the filename and the lockword 
can each contain up to 8 alpha- 
numeric characters, beginning with a 
letter. They cannot contain any 
special characters or embedded 
blanks. If you are accessing a file 
that resides in a different group or 
account, you must supply their names 
also. See the MPE System Manager 
Reference Manual for more informa- 
tion on lockwords and security. 


Examples 


FILE1/SECURITY 
PIEFILE 


4. Draw with no Pauses 
If you leave this field blank, the 
entire chart file will be drawn with 
pauses between charts. In this 
case, GRAPH draws each successive 
chart when you press CONTINUE (f2). 
If you want the charts to be drawn 
in succession without pauses, type a 
Y in this field. If you have 
entered a chart name in field 2, 
only that chart is drawn and field 4 
is ignored. 


Device Model Number 

If you do not fill in this field, 
each graph will be drawn on whatever 
device has been specified for it in 
the GRAPHING OPTIONS Menu. If you 
wish to override this device selec- 
tion, enter the model number and 
letter of the desired output device. 
For example: 


72218 


HP-IB ADDRESS 

If an HP-IB device is named in field 
5 above, enter its address here. If 
no address is given, it defaults to 
5. However, if the device used is a 
72258, T7470A, or 7580A the HP-IB ad- 
dress (usually 5) must be explicitly 
entered if HP-IB addressing is 
desired. Otherwise, non-HP-IB 
addressing is assumed. 
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7. Chart Name (Required if copying a 
chart) The name of the chart that 
you are copying. 


8. Chart File (Required if copying a 
chart from a different chart file 
than is named in field 3) 

The name of the file, including 
lockword if one exists, in which the 
chart to be copied resides. The 
default is the same chart file spe- 
cified in field 3. 


FUNCTION KEYS 


CONTINUE (f2) When drawing all of the 
chart in a chart file with pauses, press 
this key to go on to the next chart. 


REFRESH (f4) Refreshes the screen by re- 
drawing it with the information entered 
as of the last ENTER. 


EXIT (f7) Exits you from GRAPH. 
HELP (f8) Initiates Help Facility, giv- 


ing an explanation of the MAIN CONTROL 
Menu. 


ROADMAP 


RUN GRAPH.PUB.SYS 





When you run GRAPH, this menu comes different menu or exercise one of 
up on your screen. If you are in the GRAPH utilities, press DONE 
the process of designing or from the CHART DESIGN CONTROL 
modifying a chart, control is Menu and you will be returned to 
shifted to the CHART DESIGN CONTROL this menu. 


Menu. If you wish to work on a 
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Pie Chart Labels Menu 





Figure 5-32. PIE CHART LABELS Menu 


Use this menu to specify colors, tex- FIELD EXPLANATION 
tures, and labels for each segment of a 
pie chart. 1. Color 


The graph is affected by this field 
only if the output device is a plot- 
ter with multiple pens. If you do 
not enter anything in this field, 
the graph will be drawn in black. 
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You can specify any of the follow- 
ing colors: 


1. Black 
2. Red 
3. Green 
4. Blue 
5...16 


This presumes that the pens 1-4 are 
inserted in the plotter in this 
order. (See Appendix A for infor- 
mation about colors.) 


Remember that the colors are stored 
in a circular buffer, so that if you 
want the entire graph to be drawn 
with a blue pen, for example, you 
only need to specify a 4 in the 
first segment. 


Texture 

If you do not enter anything in this 
field, the segments will be drawn 
without textures. Alternatively, 
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you can enter an integer from 1 to 8 
corresponding to the textures given 
in Appendix A. The textures are 
stored in a circular buffer. 


Segment Label 

If you fill in this field, labels 
are printed next to each segment of 
the pie chart. The segment labels 
entered on this menu override labels 
taken from the data file if you spe- 
cified a label variable on the PIE 
CHART Menu. You cannot take some 
labels from the label variable and 
some from the PIE LABELS Menu. 

Since the label buffer used by this 
menu is circular, if you enter fewer 
labels than there are segments, the 
labels are repeated. 


The segment labels can be up to 25 
characters long, and can contain any 
combination of printable characters. 


The segment labels entered in this 
field can be suppressed when the 
chart is actually drawn by filling 
in the GRAPHING OPTIONS Menu appro- 
priately. 


UNIVERSITY ENROLLMENT 
BY MAJOR FIELD 


ENGINEERING 
38.0 % 


COMPUTER SC! 
19.6 % 


MATH 
10.9 % 


EDUCATION 
6.5 % 


1980 FALL SEMESTER 





Figure 5-33. Results of Pie Labels Specifications 


DISCUSSION 


The colors, textures and segment labels 


are all stored in circular buffers. The 


length of the buffer is determined by 
the buffer with the most entries. 
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For example, if the Texture column contain 
2 textures, say 1 and 2, but the Segment 
Label column contains 3 labels, the cir- 
cular buffer length is 3 for all buf- 
fers. In this case, the textures will 
alternate 1, 2, default, 1, 2, default, 
and so forth. 


For two textures to alternate, both co- 
lumns must contain the same number of 
entries. To achieve this, set the Tex- 
tures column to 1, 2, 1, 2, 1 and 2 and 
fill the Segment Label column with two 
sets of the 3 labels. 


If you enter fewer textures than there 
are segments in the pie, the textures 
are repeated from the beginning in the 
same order until all of the segments 
have textures. Colors and labels are 
treated the same way. To illustrate, if 
a pie chart has 8 segments, the fol- 
lowing specifications on the PIE LABELS 
Menu would produce these results. 
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Segment Color Texture 


OON NU EWN F 


1 
2 


Segment Label 


FUNCTION KEYS | NEXT (f6) Goes to PIE CHART TITLES Menu. 


DRAW (f3) Draws the current chart. DONE (f7) Goes to CHART DESIGN CONTROL 
Menu. 

REFRESH (f4) Refreshes the screen by re- 

drawing it with the information entered HELP (f8) Initiates Help Facility, giv- 

as of the last ENTER. ing an explanation of the PIE CHART 


LABELS Menu. 
PREVIOUS (f5) Goes to PIE CHART Menu. 
















ROADMAP 
PIE CHART 
MENU 
CHART DESIGN L&P PIE CHART 
a pas 
CONTROL, MENU LABEL 
PIE CHART PREVIOUS 
TITLES MENU 
To bring this menu to the screen, chart. You can also press NEXT 
enter Z on the CHART DESIGN from the PIE CHART Menu or PREVIOUS 
CONTROL Menu when designing a pie from the PIE CHART TITLES Menu. 
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Pie Chart Menu 


specification: (optional) 





Coptional) 





Figure 5-34. PIE CHART Menu 


Use to specify variables, data subsets, FIELD EXPLANATION 

and pie segment explosions. Also allows 

for sorting segments by size, with 1. Data Variable (Required) 

options to include data values or per- Type in name of the variable from 
centages with segments. This menu is your data file that contains the 
required for pie charts. numeric values to be plotted. This 


is the same name that you gave the 
variable in the DATA DEFINITION or 
DATA TRANSFORMATIONS Menus. 


9-105 


3a. 


3b. 


BOs 


If you need to return to the DATA 
DEFINITION Menu to recall the exact 
name of the variable, press DONE 
(f7) and enter D on the CHART 
DESIGN CONTROL Menu. ) 


Label Variable 

If your data file has a textual 
variable that contains the labels 
for each segment, enter the variable 
name here as it appears in the DATA 
DEFINITION Menu. 


Options: Include Data Values 

This box is filled in by default. 
If you do not want the actual data 
values to be printed by the seg- 
ments, space over this field to 
blank it out. 


Options: Include Percentages 

If you want to label each segment 
with its relative percentage, enter 
any character in this field. 


Options: Sort Segments in Ascending 
Order 

Since this box is already filled in 
when the menu first comes up on your 
screen, GRAPH automatically sorts 
segments with the smallest segment 
starting in the two o'clock position 
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when the graph is drawn, and pro- 
ceeding in a clockwise direction. 
If you do not want the segments to 
be sorted, blank out this box by 
spacing over it or by pressing the 
DELETE CHAR key on your terminal; 
the segments will be drawn in the 
order of the values in the data 


file. 


Explosion Specification 

If you wish to draw attention to a 
particular segment by drawing it 
slightly removed from the rest of 
the pie, enter an explosion 
specification here. The expression 
specifies the segment in terms of 
the value of a data variable. In 
general, the explosion specification 
has the form: 


vartablename relop value 


ise ae variablename relop value [...]] 


where relop is a relational oper- 
ator from Table 5-5. 


For example, consider this data file: 


DEPT EXPENSES 
MARKETING 534 
SALES 925 
MFG 829 
TRAINING 657 
QA 432 


The following expression would explode 
the segments corresponding to QA, SALES 
and MFG: 


DEPT=QA OR EXPENSES>800 


Parentheses can be used to override the 
standard order of precedence: 


1. Relational operators processed from 
left to right 

2. NOT processed from left to right 

3. AND and OR processed from left to 
right. 


If you are stating the expression in 
terms of a textual variable whose 

value contains embedded blanks, use 
quotation marks or apostrophes around 
the value. Use quotation marks around a 
value with an embedded apostrophe; like- 
wise use apostrophes around a value with 
embedded quotation marks. 
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Examples 
DEPT="R&D" 
NAME= 1 ee 1 


POSITION="BOSS'S SON" 


5. Subset Specifications 
If you want to graph a subset of the 
data file, enter a subset spe- 
cification expression. The form and 
allowable operators are the same as 
for Explosion Expressions given 
above. Note that if your data file 
contains more than 16 values for the 
data variable, you may want to select 
a subset of no more than 16 values 
for your graphing so your chart will 
be clear and easy to read. 


Table 5-5. 


Relational Operators 
For Explosions and 
Subsets 









Relational 
Operators 


Equals 

Not equal 
Greater than 
Greater than or equal to 
Less than 

Less than or equal to 


V 


AAVVA" 
Hl 


FUNCTION KEYS NEXT (£6) Goes to PIE CHART LABELS Menu. 


DRAW (f3) Draws the current chart. DONE (f7) Goes to CHART DESIGN CONTROL 
Menu. 

REFRESH (f4) Refreshes the screen by re- 

drawing it with the information entered HELP (f8) Initiates Help Facility, giv- 

as of the last ENTER. ing an explanation of the PIE CHART 
Menu. 

PREVIOUS (f5) Goes to CHART DESIGN CON- 

TROL Menu. 

ROADMAP 





CHART DESIGN C&P 
CONTROL MENU 
PIE CHART 
LABELS MENU 





PREVIOUS 





To arrive at the PIE CHART Menu, 


enter a C and P (Pie Chart) on Alternatively, you can press 
the CHART DESIGN CONTROL Menu. PREVIOUS from the PIE CHART LABELS 
Menu. 
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Pie Chart Titles Menu 
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Figure 5-35. PIE CHART TITLES Menu 


Use this menu to specify title, sub- FIELD EXPLANATION 


title, and footnote for pie charts. 
1. Title 
The title may be any combination of 
up to 45 printable characters. 
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2. Subtitle 
This subtitle is printed in the same 
text size as the title, and contains 
up to 64 printable characters. 


3. Footnote 
The footnote may be 1 or 2 lines, 
each containing up to 78 printable 
characters. 


DISCUSSION 


On this menu, you may enter any or all 
of the following: 


o a one-line title 

o a one-line subtitle, using a text size 
that is the same as the title or smal- 
ler 

o a one or two-line footnote 


In every case, GRAPH will left-justify 
the text that you enter and center it 
when it is actually printed on the 
graph. 


If the size of the text is too large, 
characters may be truncated, depending 
on the exact text positioning. 


Any of the titles entered in this menu 
can include any of the following special 
commands: 


$TODAY Represents the current date in 
the form mm/dd/yy with leading 
zeros suppressed. 
For example, 9/15/82. 


$MONTH Represents the current month 
spelled out in full. For 
example, SEPTEMBER. 


$M Represents the current month 
numerically. For example, 9. 


$DAY Represents the current numeric 
day of the month. For example, 
Ls 


$YEAR Represents the current year in 4 
digits. For example, 1982. 


$Y Represents the current year by 
its last two digits. For 
example, 82. 


For example, you might specify this 
subtitle: 


THIS GRAPH WAS PRODUCED ON $TODAY 


When the graph is drawn, the subtitle 
would be: 


THIS GRAPH WAS PRODUCED ON 9/15/82 


The titles entered on this menu can be 
suppressed when the chart is actually 
drawn by filling in the GRAPHING OPTIONS 
Menu appropriately. 
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FUNCTION KEYS 
DRAW (f3) Draws the current chart. 


REFRESH (f4) Refreshes the screen by re- 
drawing it with the information entered 
as of the last ENTER. 


PREVIOUS (f5) Goes to PIE CHART LABELS 
Menu. 


NEXT (f6) Goes to ANNOTATIONS Menu. 


DONE (f7) Goes to CHART DESIGN CONTROL 
Menu. 


HELP (f8) Initiates Help Facility, giv- 
ing an explanation of the PIE CHART 
TITLES Menu. 


ROADMAP 





PIE CHART 
LABELS MENU 
CHART DESIGN 1&P 
CONTROL MENU 
ANNOTATIONS 
MENU 






PREVIOUS 





This menu appears on your screen when PIE LABELS Menu, or when you press 
you enter TZ on CHART DESIGN CONTROL PREVIOUS from the ANNOTATIONS Menu. 
Menu, when you press NEXT from the 
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Pie Text Control 


$3 


iitiet 


ta i 
Malt 





ae 
Subtitle: 


Footnote: 


Segment Labels: 





Figure 5-36. PIE TEXT CONTROL Menu 


Use to specify color, size and font for Field Description 

text (titles, subtitles, labels and 

footnotes, but not annotations) on a pie 1. Color 

chart. This field has meaning only when the 


graph is drawn on a color device. 
Enter 0-16 or blank as shown on the 
next page. (Entering 0=1.) 
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1 Black (default) 
2 Red 

3 Green 

4 Blue 

5...16 


This presumes that the pens 1-4 are 
inserted in the plotter in this or- 
der. (See Appendix A for infor- 
mation about colors.) The maximum 
number that can be entered is 16. 
The default (blank) is 1. 


Size 

Enter a number from 1 to 72 where 1 
is the smallest text size and 72 is 
the largest. The defaults are: 


Main Title 8 
Subtitle 6 
Segment labels 4 


On plotters, software and hardware 
characters will be the same size. 
On terminals, hardware characters 
can be larger than the software 
characters. Refer to the GRAPHING 
OPTIONS Menu for a discussion of 
hardware and software characters. 
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Note: Size of text will reflect 
chart size changes and size is re- 
lative rather than absolute. If 
you have reason to shrink or stretch 
the size of a chart, you may wish to 
adjust the size specifications for 
your text to ensure legibility. 


If the text size is changed, it may 
cause text to overwrite other areas 
of the chart. It is recommended 
that you experiment to find the 
right text size for your charts. 


Font 

Enter the numbers of the fonts you 
have defined for the chart using the 
FONT DEFINITION Menu. Only four 
software fonts may be defined for a 
single chart. The default (blank) 
is font 1. 


Only one hardware font, usually 
Stick, is available. The native 
language characteristics will be 
that specified for font 1 on the 
FONT DEFINITION Menu. 


FUNCTION KEYS NEXT (f6) Goes to FONT DEFINITION Menu. 



















DRAW (f3) Draws the current chart. DONE (f7) Goes to CHART DESIGN CONTROL 
Menu. 
REFRESH (f4) Refreshes the screen by re- 
drawing the menu with the specifications HELP (f8) Initiates Help Facility, giv- 
for color, size, and font as of the ing an explanation of the PIE TEXT CON- 
last ENTER. TROL Menu. 
PREVIOUS (f5) Goes to GRAPHING OPTIONS 
Menu. 
ROADMAP 
GRAHPING OPTIONS 
MENU 
CHART DESIGN 
CONTROL MENU 
FOUR PREVIOUS 
DEFINITION MENU 
This menu appears on your screen if chart. It will also appear if you 
you enter TC on the CHART DESIGN press PREVIOUS from the FONT DEFINITION 
CONTROL Menu while designing a pie or NEXT from the GRAPHING OPTIONS Menus. 
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CHART Menu, cannot be altered on the 


taken from the LINE CHART or BAR 
QUALIFICATIONS Menu. 


Variable (display only) 


Each of the Y 


FIELD EXPLANATION 
played here. 


1. 


QUALIFICATIONS Menu 
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-“aX1ls var- 


Figure 5-37. 
Applies to bar 


Qualifications Menu 





Use this menu to select a particular 
subset of the data for each Y 


ble being graphed. 


e 


ia 
charts, line charts, and scattergrams. 


Qualifications 

Enter a qualifying expression for 
any variable that you want to qual- 
ify. The general form of a qual- 
ifying expression is the same as a 
subset expression: 


variablename relop value 
eae variablename relop value [...]] 


OR 


where relop is a relational oper- 
ator from Table 5-6. For example, 


COMPANY=ACME AND SALES<=760 
is a qualifying expression where 


COMPANY and SALES are variables 
defined in the data file. 


Parentheses can be used to override the 
standard order of precedence: 


a 


rp 


Relational operators processed from 
left to right 

NOT processed from left to right 
AND and OR processed from left to 
right 
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If you are stating the expression in 
terms of a textual variable whose 

value contains embedded blanks, use 
quotation marks or apostrophes around 
the value. Use quotation marks around a 
value with an embedded apostrophe; 
likewise use apostrophes around a value 
with embedded quotation marks. 


Examples 
DEPT="R & D" 
NAME=' a ee t 


POSITION="BOSS'S SON" 


Table 5-6. 


Relational Operators for 
Qualifying Expressions 








Equals 


<> Not equal 

> Greater than 

>= Greater than or equal to 
es Less than 

< Less than or equal to 


DISCUSSION 


In the first field, GRAPH displays the 
names of the Y-axis variables that you 
have declared on the BAR CHART or LINE 
CHART Menu. You can enter a data quali- 
fying expression for each of the var- 
iables listed. 


By using qualifying expressions, you can 
select a different subset of each var- 
iable being graphed if you wish. If in- 
stead you want to subset the entire data 
file according to the value of one var- 
liable, specify a data subset on the LINE 
CHART or BAR CHART Menu. 


To use variable qualifications, enter 
the name of the data variable on the 
LINE or BAR CHART Menu as many times as 
you wish to qualify it. For example, if 
you want to break the data variable 
NUM-EMP into four separate variables, 
enter NUM-EMP four times as a horizontal 
variable. Then press NEXT (f6) to ar- 
rive at the QUALIFICATIONS Menu, where 
GRAPH lists NUM-EMP four times for you. 
When you specify a different qualifying 
expression for each occurrence of 
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NUM-EMP, the resulting graph will be 
drawn with four dependent variables. 
Figure 5-38 shows a data file created 
through the DATA PROMPT Menu, a LINE 
CHART Menu, and a QUALIFICATIONS Menu 
filled in as an example. Figure 5-39 
shows the resulting line graph. 


FUNCTION KEYS 
DRAW (f3) Draws the current chart. 


REFRESH (f4) Refreshes the screen by re- 
drawing it with the information entered 
as of the last ENTER. 


PREVIOUS (f5) Goes to LINE CHART or BAR 
CHART Menu 


NEXT (f6) Goes to LINE CHART AXES or BAR 
CHART AXES Menu. 


DONE (f7) Goes to CHART DESIGN CONTROL 
Menu. 


HELP (f8) Initiates Help Facility, giv- 
ing an explanation of the QUALIFICATIONS 
Menu. 
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Figure 38a. Qualifications Example on 
DATA PROMPT and LINE CHART Menus 
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Line Chart Drawn Using 
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Variable Qualifications 


Figure 5-39. 


ROADMAP 





c+L 


LINE CHART 
MENU 
CHART DESIGN 
CONTROL MENU 
BAR CHART 
MENU 
AXIS DEFINITION MENUS 
(LINE OR BAR) 


To bring up this menu, press NEAT from LINE AXES or BAR AXES 
from the LINE CHART or BAR CHART Menus. 
Menus. You can also press PREVIOUS 











PREVIOUS 
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_ SECTION 6 


Using DSG/3000 





Programmatically 


Overview . 
Current Chart and Chart File 


- - Using Procedures to 


“Design a Chart 


- Using Procedures to 


Produce a Chart 


Using Procedures to 


Control Output 


Ee Using Procedures to 


Create a Figure File 


Using Procedures to 


Annotate a Graph 

- Using Procedures to © 
Design a Bar Chart 

Using Procedures to 
Control Text 

Using Procedures to 
Design a Line Graph 

Using Procedures to 
Design a Pie Chart 

Using Procedures to 
Design a Scattergram 
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6-7 
6-7 
6-8 
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6-12 
6-18 
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Overview 


A set of programmatically callable 1i- 
brary procedures is provided by DSG/3000. 
All of the capabilities of DSG/3000 are 
accessible programmatically, including 
chart design and execution. The pro- 
cedures can be called from any user- 
written program in COBOL, FORTRAN, 

BASIC, SPL, or PASCAL. 


DSG/3000 functions and capabilities are 
specified by procedures that can be di- 
vided into 4 areas: 


* Data Procedures 
Set and interrogate data file de- 
scriptions, data transformations, 
subsets, and qualifications. 


Chart Procedures 

Set and interrogate titles, axes de- 
scriptions, labels, legends, an- 
notations, fonts, chart type, and 
unique characteristics. 


Graphing Procedures 
Process data, initialize Brarbing 
device, and draw graph. 


Chart File Management Procedures 
Create and access chart file, return 
information about contents of chart 
file, copy or remove charts from 
chart file, set and interrogate com- 
ments about charts, and store and de- 
lete figures in figure files. 
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Table 6-1 lists the DSG/3000 procedures 
by function with summary information. 
Many procedures are given in pairs, 
where one procedure sets the character- 
istics, and the other returns informa- 
tion about what has been set. For exam- 
ple, GDATAFILESET sets the data file 
name, and GDATAFILEINQ returns the data 
file name. The shorthand notation used 
in this table is 


GDATAF ILE {SET} 
{INQ} 


A full description of each procedure ap- 
pears in Section VII arranged 
alphabetically for easy reference. 


PROCEDURE 


GDATAFILE{SET 
{ina 


GDEFN{SET 
{INO 


GTRAN{SET 
{INQ 


Gsus {set} 
{ino} 


GINDVAR {SET} 
{INQ} 


GDEPVAR {SET} 
{INQ} 


GLABVAR {SET} 
{INQ} 


GEXPLODE{sET} 
Ino} 


GsorT{seT} 
{ina} 


GDATAINFO 


Table 6-1. Summary of DSG/3000 Procedures 


FUNCTION 





DATA PROCEDURES 


Sets or returns data file name and value for 


missing data. 


Sets or returns definitions of all variables 
in the data file. 


Sets or returns variable transformations. 
Sets or returns data file subset specifica- 
tions. 


Sets or returns x axis (or independent) 
variable. 


Sets or returns y axis (or dependent) 
variables and data qualifications. 


Sets or returns the label variable for pie 
or bar charts. 


Sets or returns explosion expressions for 
pie chart segments. 


Sets or returns a flag to sort the x axis 
variable. 


‘Returns information about the data 


specification of the current chart. 





PROCEDURE 


FUNCTION 





CHART PROCEDURES 


GCHARTYPE{SET}| Sets or returns the chart type. 


{ina} 


GBAR{SET} 
{ina} 


GBARA SET 
INO 


ae 
{ina 


Gaxis{seT} 
{INQ} 


GAXISA{SET 
{INO 


GDEVICE {SET 
INO 


GTITLE {SET 
INQ 


GLABEL{sET} 
{ina} 


GLEGEND{sET} 
{ina} 


Sets or returns unique bar chart character- 
istics including bar axis scaling. Not 
callable from COBOL. 


Same as above, but callable from COBOL 
as well. 


Sets or returns unique pie chart 
characteristics. 


Sets or returns the scaling for any non-bar 
axis. Not callable from COBOL. 


Same as above, but callable from COBOL 
as well. 


Sets or returns output device options. 


Sets or returns title, subtitle, footnotes, 


and axes titles. 


Sets or returns labels for major tick marks. 


Sets or returns color, texture, marker, and 
legend text for line and bar charts. 


GSYMBOL{SET} 
ina} 


GSYMBOLA {SET} 
{INQ} 


GFONT {SET} 


GTEXT {SET} 
Ina} 


GTEXTA {SET} 
{INQ} 


GTEXTCONTROL 
{set} 


4 


{!NQt 
GDELETEANOT 


GREADANOT 
GREADANOTA 
GANOTINFO 


GSUPPRESS {SET} 
{ina} 


Table 6-1. Summary of DSG/3000 Procedures (continued) 


PROCEDURE FUNCTION PROCEDURE FUNCTION 


CHART PROCEDURES (cont.) 


Sets or returns annotation specifications 
(lines, boxes, arrows). Not callable from 
COBOL. 


Same as above, but callable from COBOL 
as well. 


Sets and returns font mapping of available 
fonts to font numbers. 


Sets or returns characteristics of text 
annotations. Not callable from COBOL. 


Same as above, but callable from COBOL 
as weil. 


Sets and returns size, color and font for 
legends, labels and titles. 


Deletes an annotation. 


Reads graphics cursor to position 
annotations. Not callable from COBOL. 


Same as above, but callable from COBOL 
as well. 


Returns information about all annotations 
for current chart. 


Sets or returns parts of the chart that are 
not to be drawn. 


6-3 


CHART PROCEDURES (cont.) 


GLIM iT{seT} Sets or returns the position of the corners 
{INQ} of the chart. Not callable from COBOL. 


GLIMITA {set} Same as above, but callable from COBOL 
{INO} | as well. 


GCHARTINFO Returns name and account of chart creator 
and time of creation. 








Table 6-1. Summary of DSG/3000 Procedures (continued) 


PROCEDURE FUNCTION PROCEDURE FUNCTION 


GRAPHING PROCEDURES CHART FILE MANAGEMENT PROCEDURES 











GEXECDATA Executes data transformations and GINITGRAF Initializes the global data structure. 
converts data to useable form. 


GCREATEFILE Creates a new chart file. 
GEXECHART Draws graph. 
GOPENFILE Opens an old chart file. 


GCLOSEFILE Closes an open chart file. 


GCREATECHART | Creates a new chart in the chart file. 


GGETCHART Gets an old chart from the chart file, 
making it into the current chart. 


GNUMCHARTS Returns the number of charts in the 
chart file. 


GLISTCHARTS Returns the names of the charts in the 
chart file. 


GCOMMENT {SET} Sets, modifies, or returns comments about 
{ina} a chart. 


GDELCHART Removes a chart from the chart file. 


GCOPYCHART Makes a copy of a single chart. 


GEXECFIGURE Creates the specified figure by drawing the 
current chart file to a figure file as if it were 
being drawn to a device. If the figure file 
does not already exist, it is created. 


GDELETEFIGURE| Deletes the specified figure from the figure 


file. 
GERRORMSG Returns error message if an error number 
has been returned by a procedure. 
GTERMGRAF Closes any open files. 
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Current Chart and Chart File 


A chart is a collection of design at- 
tributes that define a graph. Several 
charts can reside together in a chart 
file. An opened chart file is referred 
to as the current chart file. The chart 
file must be open (by a previous call to 
GOPENFILE or GCREATEFILE) before the 
charts within it can be accessed. A 
call to GGETCHART or GCREATECHART des- 
ignates one of the charts from the cur- 
rent chart file as the current chart. 
All subsequent data procedures, chart 
procedures, and graphing procedures 
refer to the current chart. 


Using Procedures to 
Design a Chart 


Whenever you access DSG/3000 program- 
matically, you must call GINITGRAF to 
initialize the global data area called 
GRAF. After completing all DSG/3000 
procedures, call GTERMGRAF to close the 
internal DSG/3000 files. 


To design a chart, you must call the 
following procedures in the order given. 
All of the other chart design and data 
procedures provide optional features or 
override the defaults. 
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GINITGRAF 


GCREATEFILE or 
GOPENF ILE 


GCREATECHART or 


. GGETCHART 


GDATAFILESET 


GDEFNSET 


GINDVARSET 


GCHARTYPESET 


GDEPVARSET 


GCLOSEF ILE 


GTERMGRAF 


To initialize global 
communications area. 


To create a new chart 
file or open an exist- 
ing chart. 


To create a new chart 
or modify and exist- 
ing chart. 


To specify the data 
file. 


To define and format 
all variables. 


To specify the X-axis 
(independent) variable. 


To specify the chart 
type. 


For line and bar 
charts, to specify the 
Y-axis (dependent) var- 
iables. 


To close the chart 
file. 


To close internal 
files. 


May 
be called 
in any 
order 








PIE LINE 


BAR 


















































































































































initialize GRAF area GINITGRAF GINITGRAF GINITGRAF 
what chart file? 
existing GOPENFILE GOPENFILE GOPENFILE 
new GCREATEFILE GCREATEFILE GCREATEFILE 
what chart? 
existing GGETCHART GGETCHART GGETCHART 
new GCREATECHART GCREATECHART GCREATECHART 
what data file? GDATAFILE GDATAFILE GDATAFILE 
variable names? GDEFN GDEFN 
what chart type? GCHART YPE GCHARTYPE GCHARTYPE 
independent variable? GINDVAR GINDVAR GINDVAR 
sorted? GSORT GSORT GSORT 
dependent variable? GDEPVAR GDEPVAR 
labels in data file? GLABVAR GLABVAR 
chart attributes? GPIE GBAR 
ticks, grids, scaling, GAXIS GAXIS 
etc.? 
set fonts, colors, size GTEXTCONTROL GTEXTCONTROL GTEXTCONTROL 
for ljabels, titles 
legends? 
label ticks/segments? GLABEL GLABEL GLABEL 
color, texture? {[GPIE] GLEGEND GLEGEND 
specify four active GFONT GFONT GFONT 
fonts for each chart? 
explode segment? GEXPLODE 
titles, footnotes, GTITLE GTITLE GTITLE 
axes titles? 
annotations? GSYMBOL, GSYMBOL, GSYMBOL, 
GTEXT GTEXT GTEXT 
where? GREADANOT GREADANOT GREADANOT 
size and placement? GLIMIT GLIMIT GLIMIT 
what plotting device? GDEVICE GDEVICE GDEVICE 
suppress parts? GSUPPRESS GSUPPRESS GSUPPRESS 





create figure file? 
delete figure file? 
close chart file 
close internal tables 


Figure 6-1. 


















GEXECFIGURE GEXECFIGURE 


GEXECFIGURE 









DELETEFIGURE 
GCLOSEFILE 
GTERMGRAF 





DELETEFIGURE 


GCLOSEFILE 
GTERMGRAF 















Logical Order of Procedures to 


Design Chart 
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DELETEFIGURE 
GCLOSEFILE 
GTERMGRAF 


Figure 6-1 lists the procedures that may 
be used to design a chart in logical or- 
der. As illustrated, you can call the 
procedures from GSORT through GSUPPRESS 
in any order. However, it is recom- 
mended that the order be followed so 
that you can be assured of expected re- 
sults. 


Using Procedures to 
Produce A Chart 


You may decide to design a chart inter- 
actively as described in Section IV, and 
then draw the chart from within a 
report-generating program. To program- 
matically produce a graph that has al- 
ready been designed either program- 
matically or interactively, you must 
call the following procedures in the 
order given. 


GINITGRAF To initialize the com- 
munications area. 

GOPENF ILE To open the chart file. 

GGETCHART To access the chart. 
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GEXECDATA To prepare the data. 

GEXECHART To draw the graph. 

GEXECF IGURE To draw to a figure 
file. 

GCLOSEFILE To close the chart 
file. 

GTERMGRAF To close internal 


tables. 


Using Procedures to 
Control Output 


If you draw a chart without specifying a 
particular plotting device, it will be 
produced on your graphics terminal by 
default. (If you are not using a 
graphics terminal, an error is 
returned.) To route the chart to a dif- 
ferent output device such as a plotter, 
call GDEVICESET. This procedure also 
allows you to specify the number of co- 
pies you want produced. 


If you do not specify the size or po- 
sition of the graph on the output de- 
vice, DSG/3000 will scale the output 
page appropriately. If the output de- 
vice is a plotter, the output is scaled 
so that it approximates an 8-1/2 inch x 
11 inch format (English standard). 


You can override this format by calling 
GLIMIT[A]JSET to set either the outer 
limits (frame boundary) or inner limits 
(data boundary) of the graph (see Figure 
6-2), or to use Metric standard format 
(210mm x 298.5mm). You cannot specify 
BOTH the outer and inner limits because 
DSG/3000 determines the appropriate 
space for headings and footnotes. 











Footnote 











Plotting Limits: a) outer; 
b) inner 


Figure 6-2. 


The coordinates of the plotting limits 
are given in millimeters from the bottom 
left corner. 
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Any limits set by GLIMIT[A]SET override 
the plotter limit points. When the plot- 
ting device is opened, the plotter 
limits are reset. 


To summarize, you can accept the posi- 
tion defaults or set one of the fol- 
lowing: 


outer limits (frame boundary) 

inner limits (data boundary) 

plotter limits (page boundary) 

Metric standard page (210 mm x 298.5 mm) 
English standard page (8 1/2 by 11 inches) 


Note that the default limits are English 
for most devices, D-size paper for the 
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Using Procedures to 
Create a Figure File 


To draw the current chart from the cur- 
rent chart file to a figure file you 
call GEXECDATA to prepare the data for 
drawing. You then call GEXECFIGURE to 
create the file. In effect, it is drawn 
to a figure file as if it was being 
drawn to a device. Figures stored in 
figure files may not be scaled, modi- 
fied, or rotated except by HPDRAW and 
TDP/3000. They reside in the files so 
that they may be accessed by TDP/3000, 
HPDRAW and other office systems applica- 
tions. 


To programmatically draw a previously 
prepared chart to a figure file, you 
must call the following procedures in 


the order given: 


GINITGRAF 


GOPENF ILE 


GGETCHART 


GEXECDATA 


GEXECF IGURE 


GCLOSEFILE 


GTERMGRAF 


To initialize the com- 
munications area. 


To open the chart file. 
To access the chart. 
To prepare the data. 


To draw the current 
chart to a figure file. 


To close the chart file. 


To close internal tables. 


To delete a figure that has been stored 
in a figure file, call the following 
procedures in the order given: 


GINITGRAF 


GDELETEF IGURE 


GTERMGRAF 


To initialize communi- 
cations area. 


To delete the figure. 


To close internal 
tables. 
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Using Procedures to 
Annotate a Graph 


Four types of annotations are provided 
by DSG/3000: 


box 
arrow 
line 
text 


* * F € 


You assign a unique identifying number 

to each annotation when you create it. 

To specify a box, arrow, or line, call 

GSYMBOL[A]SET, and to specify a textual 
annotation, call GTEXT[A]SET. 


It is best to position each annotation 
interactively. The program should call 
GREADANOT[A] and prompt the user to pos- 
ition the graphics cursor at the appro- 
priate point on the graph. GREADANOT[A] 
reads the cursor and returns the rela- 
tive location to the programs. If you 
are positioning an annotation requiring 
two points (box, line, or arrow) you 
must call GREADANOT[A] a second time and 
repeat the procedure. You can then pass 
coordinates of the points to 
GSYMBOL[A]SET or GTEXT[A]SET which draws 
the annotation on the screen. 


If you are setting a text annotation, 
you must also specify to DSG/3000 the 
label origin, which is the placement of 
the text relative to the digitized 
point. For example, in Figure 6-3, to 
position the annotation "High", you 
could digitize the position of "H", spe- 
cifying the label origin as the left 
part of the string. To position the an- 
notation “Low'', you could digitize the 
position of the "w' and specify the 
label origin as the right part of the 
string. 
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Annotation positions are passed in units 
that are device independent so that the 

relative position of the annotation re- 

mains the same relative to the chart re- 
gardless of size and scaling. 


GANOTINFO returns a list of annotation 
identifiers and their types. If you 
call GSYMBOL[A]INQ or GTEXT[A]INQ for a 
particular annotation (specified by 
identifier), that annotation will be 
drawn on your graphics terminal if the 
correct parameter is set. 


An annotation can be deleted by calling 
GDELETEANOT. 





82 


High 


78 


Digitized Points 


76 


74 


72 








Figure 6-3. Digitized Points and Text Annotation 
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Using Procedures to 
Design a Bar Chart 


If you specify a bar graph as the chart 
type in the GCHARTTYPESET procedure, you 
must specify at least one dependent var- 
iable by calling GDEPVARSET. Then, you 
can either draw the chart using all of 
the DSG/3000 design defaults, or you can 
call GBAR[A]SET and other design pro- 
cedures to set the attributes yourself. 
If you allow the design to default, you 
will get: 


* vertical, stacked, labeled bars 


axes internally scaled according to 
the values in the data file 


a bar drawn for each data point 
Y-axis having labeled ticks 


Y variables represented by different 
textures, but no legends 


no titles, no grids 
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For definitions and examples of usage of 
bar chart characteristics, See Section 
II, Graphing Terms and Concepts. 


Clustered or Horizontal Bars 
If you want the bars to be horizontal, 


or if you want them to be clustered 
rather than stacked, you must call 


GBAR[A]SET. For examples of the usage 
of stacked vs. clustered bars, see 
Section II. 





1980 


1979 


1978 














Bar Graph with Default 


Figure 6-. 


Characteristics 
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Bar Axis Scaling 


If you want intervals to be added at the 
beginning of the bar axis before the 
bars begin, as in Figure 6-5a, call 
GBAR[A]SET to give a value less than the 
minimum data value to the start pa- 
rameter. To add intervals at the end of 





the bar axis, call GBAR[A]SET to set the 
numintervals parameter to a value 
greater than the number of data items 
(number of bars). For example, in Fi- 
gure 6-5b, mumintervals is set equal 

to 12, although there are only three 
values in the data file. 








1975 1976 1977 


Figure 6-5. Scaling the Bar Axis a) 


using the start parameter 


SX |CEL_LCLOGQGQOb Ww 
XS XC|GEC_EV9 





Y Axis Scaling 


The default axes scaling, which takes 
the maximum and minimum values from the 
data file as the maximum and minimum 
values of the axis range (as in Figure 
6-6a), may be overridden. To do so you 
call GAXIS[A]SET, set the min and 

max parameters to the desired values, 


DEPVAR 


‘ 
N 


and set the defaults parameter. You 
can also set the size of the interval 
between major ticks by setting the 
intervalsize parameter. For example, 
in Figure 6-6b, min is set equal to 
-5, max is set equal to 20, defaults 
is set equal to 4, and intervalsize is 
set equal to 5. 








1979 


1980 


Figure 6-6. Scaling the Y Axis a) defaults 


6-16 


N 8 
Ni 


-5 


1979 





1980 


Figure 6-6. Scaling the Y Axis b) using 
the GAXIS[A]SET Procedure 


Ticks 


You can delete the ticks that appear 
along the Y-axis by setting the 

noticks parameter in the GAXIS[A]SET 
procedure. If you want both major ticks 
and smaller minor tick marks, specify 
the number of minor ticks per interval 
in the minorticks parameter of 
GAXIS[A]SET. 
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If you want to label the major ticks, 
call GLABELSET. You can label the ticks 
according to the way the axis is scaled 
by setting the type parameter equal to 

2. GLABELSET also allows you the option 
of labeling every other tick or every mth 
tick. 


Labeling the Bar Axis 


There are three ways of labeling the bar 
axis in a bar graph. In any of these 
cases you must call GLABELSET for the 
X-axis. 


Method 1 -- The data file contains a 
label variable. For example, in a bar 
graph of EXPENSES by DEPARTMENT, the DE- 
PARTMENT variable might contain de- 
partment names. To implement the 
labels, set the type parameter equal 

to 1 in GLABELSET, and call GLABVARSET 
to name the label variable, in this ex- 
ample, DEPARTMENT. 


Method 2 -- The bars are labeled nu- 
merically. For example, if the minimum 
is 1965, maximum is 1974, and interval 
width is one, the bars will be labeled 
1965, 1966, 1967,...1974. Set type 
parameter equal to 2 in GLABELSET. 


Method 3 -- You supply labels 
dynamically in a circular buffer when 
you call GLABELSET. For example, sup- 
pose the data variable MONTH contains 
numeric values 1 through 15, but you 
want the bars to be labeled JAN through 
DEC and back to JAN again. Use the par- 
ameters labelbuf, labelen, and 
numlabels in GLABELSET to specify the 
labels, and set the type parameter 
equal to 3. 
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Grids 


Either or both axes can have grid lines 
drawn through the plotting area. Spe- 
cify grids for the bar axis in a call to 
GBAR[A]SET, and for the Y-axis in a call 
to GAXKIS[A]SET. 


Legends, Colors and Textures 


The bars for each y variable are shaded 
differently in a stacked or clustered 
bar chart. If you want to show a legend 
indicating which variable is represented 
by each texture, call GLEGENDSET. This 
procedure also allows you to change the 
textures or add colors to differentiate 
the variables. 


Using Procedures to 
Control Text 


You can specify size, font, and color 
for legends, labels and titles by cal- 
ling GTEXTCONTROLSET. This procedure al- 
lows you to design your chart so that 
important information receives suitable 
emphasis. The color, size, and font 
values will be the same as those 
available through annotations. 


The range of text sizes is 1 to 72, 
where 1 is the smallest size. The 

defaults (blanks) use the following 
sizes: 


Bar and Line Charts 


Main Title 
Subtitles 

Left Axis Title 
Bottom Axis Title 
Y-axis Labels 
X-axis Labels 
Legend Text 


AE Kulu Ao 


Note that the DSG/3000 text sizes cor- 
respond to standard point measurements 
only when you plot to 8 1/2 by 11 inch 
paper. If you use a different size, the 
text size will not conform to the 
standard. 


Four software fonts may be specified for 
each chart. The mapping of the four 
fonts selected is accomplished by cal- 
ling GFONTSET. This same procedure al- 
lows you to select native language char- 
acteristics for the fonts. Only one 
hardware font is available. 
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Using Procedures to 
Design a Line Graph 


If you specify a line graph as the chart 
type in the GCHARTTYPE procedure, you 
must specify at least one dependent var- 
iable by calling GDEPVARSET. Then you 
can either draw the chart using all of 
the DSG/3000 design defaults, or you can 
call other procedures to set the attri- 
butes yourself. If you allow the design 
to default, you will get: 

* each dependent variable represented 
by a line with a different texture 
(see appendix A) but no legends 


all lines are black 
no data markers 


linear axes scaled according to the 
data and marked with labeled ticks 


no titles, no grids 





Figure 6-7. Line Graph with Default Design 
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Legends, Textures, Colors, Markers 


If you want the graph to show a legend 
indicating which line texture represents 
each variable, call GLEGENDSET. This 
procedure also allows you to change the 
assignment of textures or to use colors 
to differentiate the variables. You can 
also assign a marker from Appendix A to 
mark each data point on the line. Note 
that you must call GLEGENDSET once for 
each variable. 


Axis Scaling 


To override the default scaling, which 
takes the maximum and minimum values 
from the data file as the maximum and 
minimum values of the axis range, call 
GAXIS[A]SET. Set the min and max 
parameters to the desired values, and 
set the defaults parameter. You can 
also set the size of the interval be- 
tween major ticks by setting the 
intervalsize parameter. You can call 
GAXIS[A]SET once for each axis. 
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Labeling the Axis 


There are two ways of labeling the 
X-axis in a line graph. In either case, 
you must call GLABELSET. 


Method 1 -- The lines are labeled nu- 
merically. Set type parameter equal to 
2 in GLABELSET. 


Method 2 -- You supply labels dynam- 
ically in a circular buffer when you 
call GLABELSET. Use the parameters 
labelbuf, labelen, and numlabels 

in GLABELSET to specify the labels, and 
set the type parameter equal to 3. 

Make sure that labels match up with data 
points. 


Ticks 


You can delete the ticks that appear 
along either axis by setting the 

noticks parameter in the GAXIS[A]SET 
procedure. If you want the smaller 
minor ticks as well major ticks, specify 
the number of minor ticks per interval 
in the minorticks parameter of 
GAXIS[A]SET. 


If you want to label the major ticks, 
call GLABELSET. You can label the ticks 
numerically by setting the type pa- 
rameter equal to 2. Alternatively, you 
can supply the labels dynamically using 
the labelbuf, labelen, and 

numlabels parameters in GLABELSET, and 
setting the type parameter equal to 3. 
GLABELSET also allows you the option of 
labeling every other tick, or every 
mth tick. 


Logarithmic Scaling 


If you want either or both axes to be 
logarithmic rather than linear, call 
GAXIS[A]SET to set the scaletype 
parameter. 


Grids 

Either or both axes can have grid lines 
drawn through the plotting areas. Call 
GAXIS[A]SET to set the number of major 
ticks per grid line. 

Controlling Text Size, Color, and Font 
If you wish to design your graph so that 


all standard text receives the desired 
emphasis, call GTEXTCONTROLSET. Using 
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this procedure you can specify pen num- 
ber for color, select a text size that 

will be appropriate for the title, sub- 
title, axis labels, legend labels, and 

footnotes, and use up to four fonts per 
chart. 


The range of text sizes is 1 to 72, 
where 1 is the smallest size. The de- 
faults (blanks) use the following sizes: 


Bar and Line Charts 


Main Title 
Subtitles 

Left Axis Title 
Bottom Axis Title 
Y-axis Labels 
X-axis Labels 
Legend Text 


WI & Ulu ONO} 


Note that the DSG/3000 text sizes cor- 

respond to standard point measurements 

only when you plot to 8 1/2 by 11 inch 

paper. If you use a different size, the 
text size will not conform to the stan- 
dard. 


Use GFONTSET to map fonts to the four 
font numbers which may be used with a 
single chart. The same procedure allows 
you to specify native language char- 
acteristics for the four software fonts. 
Only one hardware font is available. 


Using Procedures to 
Design a Pie Chart 


If you specify a pie chart in the 
GCHARTTYPESET procedure, you can either 
draw the chart using all of the DSG/3000 
design defaults, or you can call GPIESET 
and other procedures to set the chart 
attributes yourself. If you allow the 
design to default, you will get: 

* a pie chart with segments drawn in 
black, no textures 


segments drawn in the order in which 
the data values appear in the data 
file, beginning at the two o'clock 
position 


no labels 


no percentages or actual values 
printed 


no exploded segments 


no titles or footnotes 


6-23 


Effective pie charts have a limited num- 
ber of segments, often no more than 16. 
Maximum number of segments permitted is 
30. If the data results in a segment of 
less than 2 degrees, a warning message 
is returned; you should subset the data 
file so that the segments and labels 
will be discernible. 


Colors and Textures 


You can assign colors and textures to 
each segment of the pie chart by calling 
the GPIESET procedure. See Appendix A 
for a table of colors and textures. 


Text Control 


You may specify color, size, and font 
for all standard text -- title, sub- 
title, labels, and footnotes. To do so, 
call GTEXTCONTROLSET. The values are the 
same as those used for annotations. 


The range of text sizes is 1 to 72, 
where 1 is the smallest size. The de- 
faults (blanks) use the following sizes: 


Pie Charts 
Main Title 


8 
Subtitles 6 
Segment Labels 4 


Note that the DSG/3000 text sizes cor- 
respond to standard point measurements 
only when you plot to 8 1/2 by 11 inch 
paper. If you use a different size, 
the text size will not conform to the 
standard. 


Four fonts may be used in a single 
chart. You specify those fonts by 
mapping them to font numbers using the 
GFONTSET procedure. The same procedure 
allows you to select native language 
characteristics for the fonts. Only one 
hardware font is available for a chart. 
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Sorting the Segments 


You may want the pie segments to be 
sorted and drawn from smallest to big- 
gest for ease of reading. Call GSORTSET 
to exercise this option. The first seg- 
ment is drawn starting at the two 
o'clock position regardless of whether 
the data is sorted. See Figure 6-8. 














Figure 6-8. Pie Chart with Default Characteristics a)unsorted 











= i 
Figure 6-8. Pie Chart with Default Characteristics b)sorted 
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Labeling the Segments 


There are 4 ways of labeling the pie 
segments: 


* actual values taken from the data 
file 


* percentages calculated from the data 
by DSG/3000 


PUBLICITY 
23.2 % 





* text taken from a label variable in 
the data file 


* text supplied directly by you 


You can use these methods alone or in 
combination. For example, you might 
want to have percentages listed together 
with the text from the label variables. 


PERSONNEL 
11.0 % 


Figure 6-9. Labeled Pie Charts: a) percents 
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Actual values and percentages are spe- 
cified by calling GPIESET. 


To specify that a variable from the data 
file is to be used for labels, call 
GLABVARSET, and also set the type par- 
ameter equal to 1 in the GLABELSET pro- 
cedure. For example, if you are making 
a pie chart of EXPENSES by DEPARTMENT 
where DEPARTMENT is the variable that 
contains department names, specify 
DEPARTMENT as the label variable when 
calling GLABVARSET. 


PUBLICITY 


Figure 6-9. 
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You can supply your own labels by cal- 
ling GLABELSET. Set the type pa- 
rameter equal to 3, and set the 
labelbuf, labelen, and numlabels 
parameters to describe the labels buf- 
fer. The first label name you put in 
the buffer corresponds to the first seg- 
ment drawn in the pie (two o'clock 
position). 


PERSONNEL 


Labeled Pie Charts: b) label variable 


Exploding Segments 


If you want to call attention to a part- 
icular segment of a pie chart, you can 
explode it by calling the GEXPLODESET 
procedure. 


BUDGET ANALYSIS 
FISCAL YEAR 1980 


RESEARCH AND DEVELOPMENT 
21.4 % 


SALES 
18.5 % 


PREPARED FOR INTERNAL USE 
BY DSG/3000 





For simplicity, you would usually want 
to explode no more than one segment of a 
pie chart. 


QUALITY ASSURANCE 
12.5 % 


PERSONNEL 
15.3 % 


Figure 6-10. Pie Chart with One 
Exploded Segment 


Using Procedures to 
Design a Scattergram 


Design a scattergram the same way you 
would design a line chart with one var- 
iation: you must call GLEGENDSET, set- 
ting the texture parameter equal to 0. 
This suppresses connecting lines between 
data points. Be sure to specify a non- 
zero value for the marker parameter. 

All of the other chart attributes of 
line graphs apply to scattergrams as 
well. 
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Calling DSG/ 3000 Procedures 


For all programming languages, the fol- 
lowing rules apply to all parameters: 


* Parameters are passed by reference; a 
literal value cannot be used as a 
parameter. 


No condition codes are returned; the 
status of the call is returned in the 
first four words of the communication 
area, included in every procedure 
call as the graf parameter. 


All parameters are required. For 
those parameters that have defaults, 
you can usually pass a 0 to allow the 
default to be taken. 


Table 7-1 shows the format of calls to 
DSG/3000 procedures from each language. 


Table 7-1. Format for Calling Procedures 












LANGUAGE PROCEDURE CALL FORMAT 





COBOL CALL “‘procedurename’’ USING parameter1, 
parameter2... 

FORTRAN CALL procedurename (parameter1, 
parameter2 . . .) 

BASIC linenumber CALL procedurename 
(parameter 1,parameter2 . . .) 

SPL procedurename(parameter1,parameter2 . . .) 

PASCAL procedurename(parameter 1 ,parameter2 . . .) 


where: 

procedurename identifies the pro- 
cedure being called. 

parameter at least one parameter 


is required for each 
procedure; the par- 
ticular parameters are 
listed in the formats 
for the individual pro- 
cedure descriptions. 
Note that when more 
than one parameter is 
specified, each is sep- 
arated by a comma; and 
for COBOL calls, by a 
comma (optional) and a 
space. 


Parameter Types 


The data types that are allowed in 
DSG/3000 procedures are shown are shown 
in Table 7-2. 


Table 7-2. Data Types Allowed for Various 







































DATA TYPE LANGUAGE 
Byte Array DISPLAY CHARACTER STRING BYTE ARRAY ARRAY OF 
PIC X(n) CHARACTER 
Integer COMP INTEGER INTEGER INTEGER INTEGER SUB- 
PIC S9(4) RANGE (in range 
of -32768..32767) 
Integer GROUP ITEM INTEGER NUMERIC INTEGER INTEGER ARRAY 
Array ARRAY ARRAY ARRAY OF INTEGER SUB- 
RANGE (in rnage of 
-32768..32767) 
Real REAL REAL 





* Since COBOL does not handle real data values, DSG/3000 provides alternative procedures which pass real 


values as ASCII strings. 


Each parameter is described according to 
its SPL generic type (integer, integer 
array, byte array, or real). This table 
is provided for those languages that do 
not call their data types by these par- 
ticular names. 


Note in particular the special handling 
of real data values when programming in 
COBOL. DSG/3000 provides an ASCII 
version for procedures that must pass 
real data values. These ASCII 
procedures are denoted with an "A' in 
the procedure name; for example, GBARSET 
becomes GBARASET when used to pass real 


values from COBOL. The string must con- 
tain a real number that is 16 characters 
long and padded with blanks if nec- 
essary. (Padding with trailing blanks is 
the recommended method. ) 


The real number itself consists of an 
integer part, a decimal point, anda 
decimal fraction (mantissa) part. A 
leading sign can be used; if it is not 
used, the default is a positive value. 
You can also use a scale factor which 
represents a power of ten by which the 
constant part is multiplied. 


The following are allowable forms of 
real numbers: 


FORM EXAMPLE EQUIVALENT VALUE 
n 20 

n 2 
n.n 20.5 
n.E+e 2.E+2 2.* 100 

.nE+e .2E+3 .2* 1000 
n.nE+-e 2.5E+2 or 2.5E-2 2.5 * 100 or 2.5 * 1/100 
nE+-e 2E+2 or 2E-2 2* 100 or 2 * 1/100 
nEe 2E2 2* 100 

.nEe .2E2 .2* 100 
n.Ee 2.E2 2.* 100 
n.nEe 2.2E2 2.2 * 100 


The range of e is from -77 to +78. The 
letter n represents a decimal integer 
with an optional sign. 
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Communications Area 


GRAF is the global communications area. 
Because procedures have no global stor- 
age of their own, you must provide the 
space necessary to store information 
that is to be shared between procedures. 
GRAF holds information about your par- 
ticular session, the current chart file, 
and the current chart. 


You should allocate a minimum of 1600 
words for GRAF. This is done in the 
GINITGRAF procedure. If you are pro- 
gramming in BASIC, you must allocate at 
least an additional 2048 words for chart 
records, so that GRAF will total about 
3700 words. You will need even more 
space if your charts contain very many 
annotations and labels. 


The first four words of GRAF return 
status information to the program. The 
rest of the communications area is for 
internal use only. 


Note that on the HP 3000, one word is 
two bytes or 16 bits. 


Table 7-3. 


GRAF Contents 








REPRESENTING 


status returned by procedure 
parameter position 
element position 

File System Error 
reserved for internal use 


wn ® @©®N — 


The GRAF words listed in Table 7-3 are 
defined as follows: 


Integer in which the procedure 
status is returned. Set to 
zero if the call is success- 
ful; to a non-zero value if an 
error occurs. If the error is 
an MPE file error, a file 
error number is also returned 
in the fourth word. It is up 
to you to provide error- 
handling routines and to re- 
set the status. (See 

Appendix C for error codes 
that may be returned here 

with their meaning.The errors 
in Appendix C are listed in 
ascending order, loosely 
grouped by procedures.) 


status 
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Integer representing which 
parameter in the calling 
sequence is in error. The 
first parameter is numbered 
one. 


parameter 
position 


Integer representing which 
element in the parameter was 
in error. For example, if the 
second color in a color 
parameter was given in error, 
a two is returned in this 
word. 


element 


File 
system 
Error 


MPE file error number (FCHECK 
number) returned by DSG/3000 
procedures when an MPE file 
error occurs. 


For example, if an error is encountered 
while setting the color of the third 
segment of a pie chart, GRAF will hold 
the following codes after the call to 
GPIESET: 


WORD 1 132 No such color 


WORD 2 4 Fourth parameter 
in error 

WORD 3 3 Third segment in 
error 


You must initialize the GRAF area before 
calling other DSG/3000 procedures by 
calling GINITGRAF. 


Format 


For every procedure, the format is given 
as: 


type type 
procedurename (param,...,param) 
in/out in/out 


The data type is given above each para- 
mater in SPL notation. Programmers 
writing in other languages should refer 
back to Table 7-2 for data types. 


Below each parameter is a code specify- 
ing whether it is for input or output: 


in DSG/3000 uses the value 
passed by this parameter 

out DSG/3000 sets or modifies 
the value of this 
parameter 

i/o DSG/3000 uses some values 


and returns other values, 
such as status information. 


For those procedures that have a special 
ASCII version, the ASCII format is given 
in COBOL format. 


For the most commonly used procedures, 
examples of Data Declarations in each 
language are included at the end of the 
procedure discussion. 
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Preparin 


our Program 
For the , r 


ew Version 


If you have been using an earlier ver- 
sion of DSG/3000, a larger communi- 
cations area is required by the version 
described in this manual in order to ac- 
comodate the enhancements. 


To run the new version of DSG/3000, you 
you should prepare the program to 
include the following: 


CAP=PH ,MR ,DS ; MAXDATA=32000 


If you have chart files prepared using 
the previous versions of DSG/3000, they 
will need to be converted. You can up- 
date these files programmatically or 
interactively. See Appendix F for 
methods of conversion. 


GANOTINFO 


Returns unique annotation identifying numbers for all annotations in the current 
chart. Also returns the type for each annotation. Callable from all languages. 


FORMAT 
IA IA IA I I 
GANOTINFO (graf,annotids,annottypes,maxannots,firstannot, 
ifo out out in in 
I 
numannots ) 
out 
PARAMETERS 
graf Integer array containing global information 
used by DSG/3000. The first word returns the call 
status. 
annotids Integer array returning unique annotation 
identifying numbers. 
annottypes Integer array returning the type of annotation 


according to the following code numbers: 


1 Box 

2 Arrow 

3 Line 

4 Text String 
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Parameters (continued) 


maxannots 


firstannot 


numannots 


DISCUSSION 


Integer variable greater than 0 specifying the 
length in words of the annottypes array. The 
annotids array is the same length as the 
annottypes array. This parameter is also the 
number of annotations to be returned. 


Integer variable indicating which annotation to 
start with. To start with the first annotation, 
set this parameter egual to one. To start with the 
mth annotaton, set it equal to m. This number 

is not necessarily the same as the annotation 
identifying number. 


Integer variable greater than 0 holding the number 
of annotation identifying numbers returned in 
annottids. 


GANOTINFO is called to return general information about all annotations that 
have been specified for the current chart. Information about a particular 
annotation is returned by GSYMBOL[A]INQ and GTEXTINQ. A chart can contain up to 
20 annotations. 


See chart on page 6-11. 
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GAXIS[A] 


Describes either axis on a line graph, or the non-bar axis on a bar graph. The 
ASCII version, callable from COBOL as well as other languages, is designated by 
an "A" in the procedure name. 


FORMAT 
IA 1 R R I R I 
GAXISSET (graf,axis,min,max,defaults,intervalsize,noticks, 
ifo in in in in in in 
I I I I I 
minorticks,gridspacing ,minorgrids,scaletype,reflect) 
in in in in in 
IA I R R I R I 
GAXISINQ (graf,axis,min,max,defaults, intervalsize,noticks 
ifo in out out out out out 
I I I I I 
minorticks,gridspacing ,minorgrids,scaletype,reflect) 
out out out out out 


CALL "“GAXISASET" USING graf,axis,min,max,defaults,intervalsize, 
noticks ,minorticks,gridspacing,minorgrids,scaletype, 
reflect 


CALL "GAXISAINQ" USING graf,axis,min,max,defaults,intervalsize, 


noticks,minorticks,gridspacing,minorgrids,scaletype, 
reflect 


778 


PARAMETERS : 


graf 


aAxts 


min 


defaults 


Integer array containing global information about 
DSG/3000. The first word returns the call status. 


Integer variable specifying the axis to be 
described according to the following code: 


1 K-axis 
2 Y-axis 


ASCII version: 16-byte array. 
REAL version: real variable. 


Lowest value of axis range. If you want to use the 
default calculated by DSG/3000 from the data, set 
the defaults parameter as specified below; 

whatever value you assign to min will be ignored. 


For bar charts, min must <=0. 


ASCII version: 16-byte array. 
REAL version: real variable 


Highest value of axis range. This default is 
ignored if you set the default parameter to 
use the maximum value from the data. 


For bar charts, max must be =>0. 

Integer variable specifying to DSG/3000 whether to 
use defaults or user supplied data to set minimum 
and maximum values for the axis range. 

1. Both minimum and maximum default to values 


calculated by DSG/3000 from the data file 
(default). 
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Parameters (continued) 


interval size 


noticks 


minorticks 


2. Minimum is set by user in min parameter; 
maxmum defaults to value calculated by DSG/3000 
from the data file. 


3. Maximum is set by user in max parameter; 
minimum defaults to value calculated by 
DSG/3000 from the data file. 


4. Minimum and maximum are set by user in min 
and max parameters, respectively. (Note that 
min must be set to value less than mz.) 


ASCII version: 16-byte array. 
REAL version: real variable. 


Specifies size of intervals in data units between 
major and minor tick marks along the axis. Major 
ticks can be labeled with data values. If you want 
DSG/3000 to calculate a default value, set 
intervalsize to a negative number or zero. 


Integer code specifying whether to display tick 
marks on this axis: 


0 Display tick marks (default) 
1 Do not display tick marks 


Integer variable specifying number of minor tick 
marks per major tick, not to exceed 10. Minor 
ticks are drawn smaller than major ticks and 
cannot be labeled. 
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Parameters (continued) 


gridspacing Integer variable specifying number of major ticks 


minorgrids 


scaletype 


reflect 


per grid line: 


O No grid lines (default) 
1 Each major tick has a grid line 
m Every nth major tick has a grid line 


Integer variable specifying whether or not grid 
lines through minor ticks are to be drawn. This 
parameter is applicable only when minorticks is 
greater than 0, gridspacing is equal to 1, and 
scaletype is equal to 2 (logarithmic scaling). 


O No minor grid lines (default) 
1 Draw minor grid lines 


Integer code specifying linear or logarithmic 
scaling: 


1 linear (default) 
2 logarithmic 


Specifying 0 results in the default, linear 
scaling. 


Draws the major and minor tick marks that have been 
specified by the mnorticks and noticks 

parameters on the opposite axis according to the 
following code: 


O no reflection (default) 
1 reflect 


{11 


DISCUSSION 


Since GAXIS[A]SET sets a single axis, it can be called twice for line graphs to 
set x and y axes, and once for bar charts to set the Y-axis. The X-axis (bar 
axis) of the bar chart is specified by GBAR[A]SET. 


The reflect parameter is used to draw tick marks on the opposite margin of the 

chart. For example, if you are setting the X-axis of a line chart, tick marks 

are drawn along the bottom axis of the graph. Setting the reflect parameter to 
1 will also draw the tick marks along the upper axis of the graph. 


See page 6-19 for line graph discussion and page 6-12 for bar chart discussion. 
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GBAR[A] 
NQ 


Sets or returns unique bar chart characteristics, including bar axis scaling. 
The ASCII version, callable from COBOL as well as other languages, is designated 
by an "A" in the procedure name. 


FORMAT 
IA I I R I 7 
GBARSET (graf,grouping,orientation,start,defaults ,numintervals, 
i/o in in in in in 
i 
gridspacing) 
phe 
IA I I R i I 
GBARINQ (graf,grouping,orientation,start,defaults ,numintervals, 
ifo out out out out out 
I 
gridspacing) 
out 


CALL "GBARASET” USING graf,grouping,orientation,start,defaults, 
numintervals,gridspacing 


CALL "GBARAINQ" USING graf,grouping,orientation,start,defaults 
numintervals,gridspacing 
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PARAMETERS 


graf 


grouping 


orientation 


start 


defaults 


Integer array containing global information used by 
DSG/3000. The first word returns the call status. 


Integer code specifying whether the bars will be 
stacked or clustered: 


1 stacked bars (default) 
2 clustered bars 


Specifying a 0 results in the default, stacked 
bars. 


Integer code specifying whether the bars will be 
drawn vertically or horizontally: 


1 vertical bars (default) 
2 horizontal bars 


ASCII version: 16-byte array 
REAL version: real variable 


The minimum value of the bar axis range. If you 
want blank space to precede the first bar in the 
graph, supply a number less than the lowest value 
taken by the independent variable. This value is 
used or ignored depending on the value of the 
defaults parameter. 


Integer code specifying whether to take the minimum 
value from the start parameter or from the data: 


1 minimum from data (default) 
2 use value given by start 
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Parameters (continued) 


numintervals 


gridspacing 


DISCUSSION 


See page 6-12. 


Integer variable specifying number of intervals 

to be plotted, not to exceed 60. A negative number 
or 0 specifies that DSG/3000 should take the 
default from the data. 


Integer code specifying number of intervals between 
grid lines: 

O no grid lines (default) 

1 one bar between grid lines 


nn bars between grid lines 


The value of m must be less than the number of 
intervals in the numintervals parameter. 
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GCHARTINFO 


Returns user name and account name of chart creator and the date 
of creation. Callable from all languages. 


FORMAT 
IA BA BA 
GCHARTINFO (graf,createdate,creator) 
i/o out out 
PARAMETERS 
graf Integer array containing global information 
used by DSG/3000. The first word returns the call 
status. 
createdate 8-byte array returning the date the chart was 
created. The format is "mm/dd/yy’. 
creator 17-byte array returning user name and account name 


of chart creator. Format is "user.account’. 
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SET 
GCHARTYPE | 
INQ 


Sets or returns the chart type. Callable from all languages. 


FORMAT 
IA A 
GCHARTYPESET (graf,charttype) 
ifo in 
IA I 
GCHARTYPEINQ (graf,charttype) 
i/o out 
PARAMETERS 
graf Integer array containing global information used by 
DSG/3000. The first word returns the call status. 
charttype Integer code specifying chart type: 


1 Annotations only (default) 

2 Line (includes Scattergrams) 
3 Bar 

4 Pie 
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DATA DECLARATIONS - GCHARTYPESET, GCHARTYPEINQ 
COBOL: DATA DIVISION. 
Ol GRAF. 
05 GSTATUS PIC S9(4) COMP. 
O05 PARAMETER PIC $9(4) COMP. 
O05 ELEMENT PIC S9({4) COMP. 
OS FILE-ERR PIC $9(4) COMP. 
O05 FILLER PIC $9(4} COMP OCCURS 1596 TIMES. 
O01 CHART-TYPE PIC S$9(4) COMP. 
CALL “GCHARTYPESET" USING GRAF, CHART-TYPE. 
BASIC: 10 REM G IS GRAF ARRAY C IS CHART-TYPE 
15 REM STATUS IS G[1] 
20 INTEGER G[3700], C 
50 CALL GCHARTYPESET (G[*],C) 
FORTRAN: INTEGER GRAF (1600), CHARTTYPE 
é INTEGER STATUS 
EQUIVALENCE (STATUS ,GRAF(1)) 
CALL GCHARTYPESET (GRAF, CHARTTYPE) 
SPL: INTEGER ARRAY GRAF(0:1599)-; 
DEF INE 
STATUS = GRAF (0)#; 
INTEGER CHART’ TYPE; 
GCHARTYPESET (GRAF, CHART’ TYPE); 
PASCAL : TYPE 
SMALL _INT=-32768...32767 
GRAF TYPE=record 
status:small int; 
parameter :small-int; 
element :small_ int; 
file_err :small_int; 
graffarea :small int; 
end; 
VAR 
GRAF :GRAF TYPE ; 
CHART_TYPE: small _ int; 


GCHARTYPESET (GRAF ,CHART_TYPE) ; 
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GCLOSEFILE 


Closes the current chart file. Callable from all languages. 


FORMAT 
IA 
GCLOSEFILE (graf) 
i/o 
PARAMETERS 
graf Integer array containing global information used 
by DSG/3000. The first word returns the call 
status. 
DISCUSSION 


GCLOSEFILE updates any outstanding chart records and closes the chart file. If 
the chart file was specified as temporary when it was created, it is purged. 
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DATA DECLARATIONS - GCLOSEFILE 


COBOL : DATA DIVISION. 
Ol GRAF. 
05 GSTATUS PIC S$9(4) COMP. 
O05 PARAMETER PIC $9(4) COMP. 
O05 ELEMENT PIC $9(4) COMP. 
OS: “FIT LE=ERR Pic S$9(4) 
05 FILLER PIC $9(4) 


CALL "GCLOSEFILE” USING GRAF. 


BASIC: 10 REM G IS GRAF ARRAY 
15 REM STATUS IS G[1] 
20 INTEGER G[3700] 


50 CALL GCLOSEFILE (G[*]) 


FORTRAN: INTEGER GRAF (1600) 
INTEGER STATUS 


EQUIVALENCE (STATUS,GRAF(1)) 


CALL GCLOSEFILE (GRAF) 


SPL: INTEGER ARRAY GRAF (0:1599) ; 
DEFINE 
STATUS = GRAF (0)#; 
INTEGER STATUS=GRAF (0); 


GCLOSEFILE (GRAF); 


CAL: TYPE 
ia SMALL_INT=-32768. ..32767 
GRAFTYPE=record 
status:small_int;. 
parameter :small-int; 
element :small_int; 
file err :small_int; 
graffarea :small_int; 
end; 


VAR 
GRAF :GRAFTYPE; 


GCLOSEFILE (GRAF); 
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COMP . 
COMP OCCURS 1596 TIMES. 


SET 
GCOMMENT | 
INQ 


Sets or returns comments about a chart in the chart file. Callable from all 
languages. 


FORMAT 
IA BA BA a 
GCOMMENTSET (graf ,chartname,commentsbuf,commentslen) 
i/o in in in 
IA BA BA i 
GCOMMENTINQ (graf,chartname,commentsbuf,commentsbuflen, 
ifo in out in 
I I 
commentslen,charttype) 
out out 
PARAMETERS 
graf Integer array containing global information 
used by DSG/3000. The first word returns the 
call status. 
chartname Byte array holding name of chart whose 


comments are being set or returned. 
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Parameters (continued) 
comment sbuf Byte array holding comments about the chart. 


commentslen Integer variable giving length of comments in 
bytes. Maximum is 80 characters. 


commentsbuflen Integer variable giving length in bytes of the 
buffer to receive the comments. 


charttype Integer variable returning chart type 
according to the following code: 


1 Annotations only 
2 Line (includes Scattergrams) 
3 Bar 
4 Pie 
DISCUSSION 


GCOMMENT is a helpful documentation tool, especially when you are using your 
chartfile as a portfolio containing several charts. 
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GCOPYCHART 


Makes a copy of one chart, including all specifications. Callable from all 
languages. . 


FORMAT 
IA BA BA BA BA 
GCOPYCHART (graf,fromchart,fromfile,tochart,tofile) 
i/o in in in in 
PARAMETERS 
graf Integer array containing global information used by 
DSG/3000. The first word returns the call status. 
fromehart 16-byte array holding name of the chart being 
copied. 
fromfile 36-byte array holding name of file containing 
chart being copied. 
tochart 16-byte array holding name of destination chart. 
tofile 36-byte array holding name of file containing 
destination chart. 
DISCUSSION 


Before calling GCOPYCHART, be sure that the file specified in the tofile 
parameter has been created with a previous call to GCREATEFILE. The tofile 
can be any DSG/3000 chartfile. 


If you want to rename a chart, call GCOPYCHART and pass the same file name to 
the fromfile and tofile parameters. You can then delete the old chart by 
calling GDELCHART. 


GCOPYCHART compacts the amount of space needed for the new chart. 
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GCREATECHART 


Initializes a new chart and adds the name to the current chart file directory. 
Callable from all languages. 


FORMAT 
A BA 
GCREATECHART (graf ,chartname) 
i/o in 
PARAMETERS 
graf Integer array containing global information used by 
DSG/3000. The first word returns the call status. 
chartname Byte array holding unique name of new chart. Must 
be 16 characters starting with a letter. 
DISCUSSION 


GCREATECHART initializes records containing chart attributes, labels, 
annotations, and data definition to their defaults. The chart identified in 
GCREATECHART becomes the current chart, meaning that subsequent chart, data and 
graphing procedures refer to this chart. The chart name must be unique to the 
chart file in which it resides. 
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DATA DECLARATIONS - GCREATECHART 


COBOL : 


BASIC: 


FORTRAN: 


SPL: 


DATA DIVISION. 
O1 GRAF. 
05 GSTATUS 


OS PARAMETER 
OS ELEMENT 
OS FILE-ERR 
O05 FILLER 


O01 CHART-NAME 


PIC 
PIC 
PIC 
PIC 
PIC 
PIC 


KNNNWNY 


—“~OOWOW 
re een 


HrhhaAh 


COMP . 
COMP . 
COMP . 
COMP . 
COMP OCCURS 1596 TIMES. 


CALL “GCREATECHART" USING GRAF, CHART-NAME. 


10 REM G IS GRAF ARRAY 
15 REM STATUS IS G[1] 


20 INTEGER G[3700] 
30 DIM C$[16] 


C$ IS CHART NAME 


50 CALL GCREATECHART (G[*],C$) 


INTEGER GRAF (1600) 
INTEGER STATUS 


CHARACTER*16 CHARTNAME 


EQUIVALENCE (STATUS, GRAF (1) ) 


CALL GCREATECHART (GRAF, CHARTNAME ) 
INTEGER ARRAY GRAF (0:1599) ; 


DEFINE 


STATUS = GRAF (0)#; 
BYTE ARRAY CHART’ NAME (0:15} ; 


GCREATECHART (GRAF, CHART’ NAME) ; 
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PASCAL: TYPE 

SMALL _INT=-32768. .32767 

GRAF TYPE=record 
status :small_ int; 
parameter:small int; 
file_err :small int; 
graffarea:small int; 

end; 


GRAF :GRAF TYPE ; 
CHART_NAME:PACKED ARRAY [1..16] OF CHAR; 


VAR 


GCREATECHART (GRAF , CHART_NAME ) ; 
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GCREATEFILE 


Builds and initializes a new chart file. Callable from all languages. 


FORMAT 
IA BA I I 
GCREATEFILE (graf ,filename,numcharts ,domain) 
ifo in in in 
PARAMETERS 
graf Integer array containing global information used by 
DSG/3000. The first word returns the call status. 
filename Byte array holding name of chart file. Must be 36 
alphanumeric characters (including lockword, group, 
and account) beginning with an alphabetic 
character. 
numcharts Integer variable giving the maximum number of 
charts to be included in this chart file. 
domain Integer variable indicating whether the file is 


permanent : 


1 Temporary (purged by GCLOSEFILE) 
2 Permanent 


If you supply a 0, domain will default to a 
permanent file. 
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DISCUSSION 


A call to GCREATEFILE builds and opens the chart file. The file is opened with 
exclusive access, and file code 1083 is assigned to the chart file. 


Since the chart file directory can accommodate up to 50 entries, the maximum 


number of charts in each chart file is 50. 


DATA DECLARATIONS - GCREATEFILE 


COBOL : DATA DIVISION. 
Ol GRAF. 
05 GSTATUS PIC $9{4) COMP. 
O5 PARAMETER PIC S$9(4) COMP. 
O5 ELEMENT PIC S9(4} COMP. 
O05 FILE-ERR PIC $9(4) COMP. 
O05 FILLER PIC $9(4) COMP OCCURS 1596 TIMES. 
Ol CHART-FILE-INFO. 
O05 FILE-NAME PIC X(36) VALUE “NEWCHART ". 
O05 NUM-CHARTS PIC S$9(4} COMP VALUE 25. 
05 DOMAIN PIC $9(4) COMP VALUE 2. 


CALL "GCREATEFILE" USING GRAF, FILE-NAME, 
NUM-CHARTS, DOMAIN. 


BASIC: 10 REM G IS GRAF ARRAY N IS NUM-CHARTS 
20 REM D IS FILE DOMAIN FS IS FILE NAME 
25 REM STATUS IS G[1] 
30 INTEGER G[3700}, N, D 
40 DIM F$[36] 


5O FS$="NEWCHART " 
60 N=25 
D=2 


100 CALL GCREATEFILE (G[*],F$,N,D) 
FORTRAN: INTEGER GRAF (1600), NUMCHARTS, DOMAIN 


INTEGER STATUS 
CHARACTER*36 FILENAME 
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SPL: 


PASCAL: 


EQUIVALENCE (STATUS,GRAF(1)) 


FILENAME="NEWCHART “ 
NUMCHARTS=25 
DOMAIN=2 


CALL GCREATEFILE (GRAF, FILENAME, NUMCHARTS, DOMAIN) 


INTEGER ARRAY GRAF (0:1599) ; 
DEFINE 
STATUS = GRAF (0)#; 
BYTE ARRAY FILE’NAME(0:35):="NEWCHART "; 
INTEGER NUMCHARTS:=25, 
DOMAIN: =2; 


GCREATEFILE (GRAF, FILE’NAME, NUMCHARTS, DOMAIN}; 


TYPE 
small_int=-32768. .32767; 
graftype =record 


status :small_int; 
parameter :small_ int; 
element :small_int; 
file _err :small_ int; 
graffarea :array[1..1596] of small_int; 
end; 
VAR 
GRAF :graftype; 


FILENAME :packed array [1...36] of char; 
NUM CHART:small_ int, 
DOMAIN :small_ int; 


GCREATEFILE(GRAF , FILENAME ,NUM_CHART , DOMAIN) ; 
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GDATAFILE 


Sets or returns the data file name and the value indicating missing data. 
Callable from all languages. 


FORMAT 
IA BA BA I 
GDATAFILESET (graf,filename,missbuf ,misslen) 
i/o in in in 
IA BA BA I I 
GDATAFILEINQ (graf,filename,missbuf ,missbuflen,misslen) 
i/o out out in out 
PARAMETERS 
graf Integer array containing global information used by 
DSG/3000. The first word returns the call status. 
filename 36-byte array holding the fully qualified name of 
the data file. Must be terminated by a space or 
semi-colon. 
missbuf 12-byte array holding the numeric value 
representing missing data in the data file. A 
buffer of all blanks is treated as 0. 
misstlen Integer variable giving length in bytes of the 


missing data value. 
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Parameters (continued) 


missbuflen Integer variable giving maximum number of bytes to 
be returned in missbuf. 


DISCUSSION 


See page 3-21. 


DATA DECLARATIONS - GDATAFILESET, GDATAFILEINQ 


COBOL : DATA DIVISION. 

O1 GRAF. 
05 GSTATUS PIC S$9(4) COMP 
05 PARAMETER PIC S$9(4) COMP 
05 ELEMENT PIC S$9(4) COMP 
OS FILE-ERR PIC $9(4) COMP. 
OS FILLER PIC S$9(4) COMP OCCURS 1596 TIMES. 

O01 DATA-FILE-INFO. 
OS FILE-NAME PIC X(36). 
0S MISS-BUF PIC X(16). 
0S MISS-LEN PIC S$9(4) COMP. 
05 MISS-BUF-LEN PIC S$9(4) COMP. 


CALL "GDATAFILESET" USING GRAF, FILE-NAME, 
MISS-BUF, MISS-LEN. 


BASIC: 10 REM G IS GRAF ARRAY F$ IS DATA FILE NAME 
20 REM M$ IS MISS-BUF Mi IS MISS-LEN 
25 REM M2 IS MISS-BUF-LEN 
30 REM STATUS IS G[1i] 
40 INTEGER G[3700], M1, M2 
50 DIM F$[{36], M$[16} 


100 CALL GDATAFILESET (G[*],F$,M$,M1) 
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FORTRAN: 


SPL: 


PASCAL: 


INTEGER GRAF(1600), MISSLEN, MISSBUFLEN 
CHARACTER*36 FILENAME, MISSBUF*16 
INTEGER STATUS 


EQUIVALENCE (STATUS ,GRAF(1)) 


CALL GDATAFILESET (GRAF, FILENAME, MISSBUF, MISSLEN) 


INTEGER ARRAY GRAF (0:1599) ; 
DEF INE 

STATUS = GRAF (0)#; 
BYTE ARRAY FILE’ NAME(0:35); 
BYTE ARRAY MISS’ BUF (0:15); 
INTEGER MISS’LEN, MISS’ BUF’LEN; 


GDATAFILESET (GRAF, FILE’NAME, MISS’ BUF, MISS’LEN); 


TYPe 
SMALL _INT=-32768. .32767; 
GRAFTYPE =record 


status :small_ int; 
parameter :small_ int; 
element :small_ int; 
fi ke err :small_ int; 
auerrates :array[1..1596] of small_int; 
end; 
VAR 
GRAF :GRAFTYPE ; 


FILENAME :PACKED ARRAY [1..36] OF CHAR; 
MISSBUFLEN:SMALL_INT; 
MISSLEN :SMALL_INT; 
MISSBUF :PACKED ARRAY [1..36] OF CHAR; 


GDATAFILESET (GRAF ,F ILENAME ,MISSBUF ,MISSLEN) ; 
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GDATAINFO 


Returns information about the data specification for the current chart. Callable 
from all languages. 


FORMAT 


IA I 


BE I i I 


GDATAINFO (graf ,numdefns ,numtrans ,numdvars ,explodelen,qualen, 


PARAMETERS 


graf 


numdefns 


numtrans 


numdvars 


explodelen 


qualen 


ifo out 


ne I 


out out out out 


translen,subsetlen) 
out out 


Integer array containing global information used by 
DSG/3000. The first word returns the call status. 


Integer variable 
definitions. 


Integer variable 
variables. 


Integer variable 
variables. 


Integer variable 
of the explosion 


Integer variable 


returning number of variable 


returning number of transformed 


returning number of Y-axis 


returning the length in bytes 


expression. 


returning the length in bytes of 


the Y-axis variable qualifications. 
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Parameters (continued) 


translen Integer variable returning the length in bytes of a 
single transformation expression. 


subsetlen Integer variable returning the length in bytes of 
the data file subset specification. 
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SET 
NQ 


GDEFN 


Sets or returns variable definitions for a data file. Definitions for all of 
the variables are set or returned together. Required for all chart types except 
slides. Callable from all languages. 


FORMAT 
IA I BA IA I IA IA 
GDEFNSET (graf ,numdefn,varbuf,typebuf, format ,posbuf, lenbuf) 
i/o in in in in in in 
IA I I I BA I 
GDEFNINQ (graf,firstdefn,maxdefn,numdefn,varbuf,varbuflen, 
i/o in in out out in 
IA I IA IA 
typebuf , format, posbuf , lenbuf) 
out out out out 
PARAMETERS 
graf Integer array containing global information used 


by DSG/3000. The first word returns the call 
status. If an error is detected, the second word 
contains the number of the parameter in error. 
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Parameters (continued) 


numdefn 


varbuf 


typebuf 


format 


posbuf 


Integer variable specifying number of variable 
definitions. Maximum is 9. 


Byte array containing a collection of 16-byte 
names, one for each data variable. 


You cannot use any of the following reserved words 
as variable names: 


ABS LN MOVEAVG 

AND LOG NOT 

CUMULATE MOD OR 
SQRT 


Integer array specifying variable types according 
to the following code: 


1 text (ASCII) 
2 numeric (ASCII) 


Integer code specifying free or fixed format data 
file: 


1 free format 
2 fixed format 


Integer array specifying the position of a variable 
within a data record. In free format, posbuf is 

a field number (where the first field is field 

1). In fixed format, it is a byte offset, 

where the first byte in the record has offset 0. 
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Parameters (continued) 


Lenbuf 


firstdefn 


maxdefn 


varbuflen 


DISCUSSION 


Integer array specifying lengths of data values. 
Only used for fixed format. 


Integer variable specifying which variable definition is 
the 1st one to be returned. The definitions are numbered 
beginning with one. 


Integer variable specifying the maximum number of 
definitions to be returned. 


Integer variable specifying length in bytes of the 
buffer to receive the variable names. 


Independent and Dependent variables: page 2-3; Data File Format: page 3-2. 


GDEFNINQ can be used to return a subset of the defined variables. For example, 
if 9 variables have been defined and you want the 6th through 9th to be 
returned, set firstdefn equal to 6 and maxdefn equal to 4. 


i Gate Yi 


DATA DECLARATIONS - GDEFNSET, GDEFNINQ 


COBOL: 


BASIC: 


FORTRAN: 


DATA DIVISION. 


O1 GRAF. 

05 GSTATUS PIC S$9(4) COMP 

O05 PARAMETER PIC $9(4} COMP 

0S ELEMENT PIC S$9(4} COMP 

O05 FILE-ERR PIC S$9(4) COMP. 

O05 FILLER PIC $9(4} COMP OCCURS 1596 TIMES. 
O1 VARIABLE-DEFINITIONS. 

O05 NUM-DEFN PIC S9(4) COMP VALUE 2. 


OS VAR-BUF. 

10 VAR-VALUES PIC X(16) OCCURS 2 TIMES. 
O05 TYPE-BUF. 

10 TYPE-VALUES PIC $9(4) COMP OCCURS 2 TIMES. 


05 FORMAT PIC $9(4) COMP. 
0S POS-BUF. 

10 POS-VALUES PIC $9(4} COMP OCCURS 2 TIMES. 
05 LEN-BUF. 

10 LEN-VALUES PIC $9(4) COMP OCCURS 2 TIMES. 
05 FIRST-DEFN PIC S9{4} COMP. 
OS MAX-DEFN PIC S$9(4) COMP. 
05 VAR-BUF-LEN PIC $9(4) COMP. 


CALL “GDEFNSET" USING GRAF, NUM-DEFN, VAR-BUF, 
TYPE-BUF , FORMAT, 
POS-BUF, LEN-BUF. 


10 REM G IS GRAF ARRAY N IS NUM-DEFN 

20 REM V$ IS VAR-BUF T IS TYPE-BUF 

30 REM Fl IS FORMAT P IS POS-BUF 

40 REM L IS LEN-BUF F2 IS FIRST-DEFN 
50 REM M IS MAX-DEFN V IS VAR-BUF-LEN 


60 REM STATUS IS G[1] 

70 INTEGER G[3700], N, Fl, 
80 INTEGER T(2), P(2), L(2) 
90 DIM V$[32] 

100 N=2 


F2;-M, V 


150 CALL GDEFNSET (G[*],N,V$,T{*],F1,P([*],LI[*]) 
INTEGER GRAF(1600), NUMDEFN, TYPEBUF(2), FORMAT 
INTEGER POSBUF(2}), LENBUF(2), FIRSTDEFN, MAXDEFN 
CHARACTER*16 VARBUF (2) 

INTEGER STATUS 
EQUIVALENCE (STATUS,GRAF(1)} 


NUMDEFN=2 


CALL GDEFNSET (GRAF, NUMDEFN, VARBUF, TYPEBUF, 
x FORMAT, POSBUF, LENBUF ) 
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SPL: 


PASCAL : 


INTEGER ARRAY Sa Se 15 
TYPE’ BUF ( 
POS BUF (0: 
LEN’ BUF (0: 
DEFINE 


STATUS = GRAF (0)#; 
INTEGER NUM’DEFN:=2, 
FORMAT , 
FIRST ’DEFN, 
MAX ’DEFN, 
VAR’ BUF’ LEN: =32; 
BYTE ARRAY VAR’ BUF (0:31); 


GDEFNSET (GRAF, NUM’DEFN, VAR’ BUF, TYPEBUF, FORMAT, 
POS’ BUF, LEN’ BUF); 


TYPE 
SMALL _INT=-32768..32767; 
GRAFTYPE =record 


status :small_ int; 
parameter :small_ int; 
element :small Tint: 
file_err :small_int; 
gi at terse arrayti. .1596] of small_int; 
end; 
VAR 
GRAF :GRAFTYPE ; 
VARBUF :ARRAY [1...2] OF CHAR16; 


NUMDEFN, FORMAT , FIRSTDEFN, MAXDEFN: SMALL_INT;: 
LENBUF , TYPEBUF , POSBUF :ARRAY [1...2] OF ~SMALL_ INT; 


GDEFNSET(GRAF , NUMDEFN, VARBUF , TYPEBUF , FORMAT , POSBUF , LENBUF ) ; 
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GDELCHART 


Removes a chart from the chart file. Callable from all languages. 


FORMAT 
A BA 
GDELCHART (graf,chartname) 
i/o in 
PARAMETERS 
graf Integer array containing global information used 
by DSG/3000. The first word returns the call 
status. 
chartname 16-byte array holding name of chart to be deleted. 
DISCUSSION 


The chart file containing the chart you want deleted must be opened before you 
call GDELCHART. 


GDELCHART removes the chart name from the directory and corresponding chart 
records are removed from the file. 
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GDELETEANOT 


Deletes an annotation from the chart description. Callable from all languages. 


FORMAT 
IA I 
GDELETEANOT (graf,annotid) 
ifo in 
PARAMETERS 
graf Integer array containing global information used by 
DSG/3000. The first word returns the call status. 
annotid Integer variable uniquely identifying the 
annotation. 
DISCUSSION 


GSYMBOLINQ and GTEXTINQ can be called before GDELETEANOT to verify the 
identifying number of the annotation you wish to delete. 


Deleting an annotation compacts the remaining ones so that any new annotations 
are added to the end of the list. 
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GDELETEFIGURE 


Deletes the specified figure from the specified figure file. Callable from all 
languages. 


FORMAT 
IA BA BA 
GDELETEFIGURE (graf,figurename,figurefile) 
in in in 
PARAMETERS 
graf Integer array containing global information used 
by DSG/3000. The first word returns the call 
status. 
figurename 16-byte array containing the name of the figure 
to be deleted. 
figurefile 36-byte array containing the name of the figure 


file in which the figure to be deleted resides. 
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GDEPVAR 


Sets or returns all Y-axis (dependent) variables as a group. Required for line 
graphs and bar charts. Callable from all languages. 


FORMAT 


IA I BA BA I 
GDEPVARSET (graf ,numvars ,varbuf ,qualbuf,qualen) 
i/o in in in in 


IA I BA I BA 
GDEPVARINQ (graf ,numvars,varbuf ,varbuflen,qualbuf, 
ifo out out in out 


I I 
qualbuflen,qualen) 
in out 


PARAMETERS 


graf Integer array containing global information used by 
DSG/3000. The first word returns the call status. 
If an error is detected, the second word contains 
the number of the parameters in error. 


numars Integer variable specifying number of Y-axis 


(dependent) variables. Maximum number allowed 
is 8. . 
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Parameters (continued) 


varbuf 


qual buf 


qualen 


varbuflen 


qualbuflen 


DISCUSSION 


Byte array holding 16-byte names of variables. 


Byte array holding qualifications. All 
qualifications are the same length, as specified by 


quaten. 


Integer variable specifying length in bytes of a 
single qualification. A length of 0 implies no 
qualifications. 


Integer variable specifying size in bytes of buffer 
to receive the variable names. 


Integer variable specifying length in bytes of 
buffer to receive the qualifications. 


These procedures are not used for pie charts or slides. 


GDEPVARINQ will return a warning message if you set varbuflen too small to 
receive all of the variable names of if you set qualbuflen too small to 
receive all of the qualifications. 


For information about Dependent Variables: page 2-3. 
For information about qualifying dependent variables: page 3-14. 
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DATA DECLARATIONS - GDEPVARSET, GDEPVARINQ 


COBOL : 


BASIC: 


FORTRAN: 


DATA DIVISION. 
O01 GRAF. 

05 GSTATUS PIC $9(4) COMP. 

O05 PARAMETER PIC S$9(4) COMP. 

OS ELEMENT PIC oe COMP . 

O05 FILE-ERR PIC S$9{4) COMP. 

O5 FILLER PIC $9 (4) COMP OCCURS 1596 TIMES. 
Ol DEPENDENT-VAR. 

05 NUM-VARS PIC S$9(4) COMP VALUE 3. 

05 VAR-BUF. 

10 VAR-VALUES PIC a OCCURS 3 TIMES. 
OS QUAL-BUF PIC X(5 
O05 QUALEN PIC SOT 4) “COMP VALUE 10. 


OS VAR-BUF-LEN PIC S9(4} COMP VALUE 48. 
OS QUAL-BUF-LEN PIC S9{4) COMP VALUE 50. 


CALL “GDEPVARSET" USING GRAF, NUM- SOULTE ge: BUF , 
QUAL-BUF, QUALE 


10 REM G IS GRAF ARRAY N IS NUM-VARS 

20 REM V$ IS VAR-BUF Q$ IS QUAL-BUF 
30 REM Ql IS QUALEN V IS VAR-BUF-LEN 
40 REM Q2 IS QUAL-BUF-LEN 

50 REM STATUS IS G[1] 

60 INTEGER G[3700], N, Q1, V, Q2 

70 ety V$[48], Q$[50] 


150 CALL GDEPVARSET (G[*],N,V$,Q$ ,Q1) 

INTEGER BUALBUECOR. NUMVARS, QUALEN, VARBUFLEN 
INTEGER QUALBUFLE 

CHARACTER* 16 VARBUF (3). QUALBUF *50 

INTEGER STATUS 

EQUIVALENCE (STATUS,GRAF(1)) 


DATA NUMVARS/3/, Pe a ee VARBUFLEN/48/ 
DATA QUALBUFLEN/50/ 


CALL GDEPVARSET (GRAF, NUMVARS, VARBUF, 
QUALBUF , QUALEN}) 


TUS 


SPL: INTEGER ARRAY GRAF (0:1599); 
DEFINE 
STATUS = GRAF (0)#; 
INTEGER NUM’VARS:=3, 
QUALEN: =10, 
VAR’ BUF’ LEN: =48, 
QUAL’ BUF’ LEN: =50; 
BYTE ARRAY VAR’ BUF (0:47), 
QUAL’ BUF (0:49); 


GDEPVARSET (GRAF, NUM’VARS, VAR’BUF, QUAL’ BUF, 
QUALEN) ; 


PASCAL: TYPE 
SMALL INT=-32768. .32767; 
GRAFTYPE =record 


status :small_int; 
parameter :small_int; 
element :small_ int; 
file_err :small_ int; 
qrattanee :array[1..1596] of small_int; 
end; 
VAR 
GRAF :GRAF TYPE ; 
VARBUF :ARRAY [1...3] OF CHAR16; 


NUMVARS , QUALEN, VARBUFLEN, QUALBUFLEN: SMALL_INT; 
QUALBUF :PACKED ARRAY [1...50] OF CHAR; 


GDEPVARSET (GRAF , NUMVARS , VARBUF , QUALBUF , QUALEN) ; 
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GDEVICE 


Sets or returns plotting device and device-dependent specifications. Callable 
from all languages. 


FORMAT 
IA BA I I I I 
GDEVICESET (graf,device,hpib, copies ,penspeed,chartype) 
i/o in in in in in 
IA BA a I a I 
GDEVICEINQ (graf,device ,hpib, copies ,penspeed,chartype) 
ifo out out out out out 
PARAMETERS 
graf Integer array containing global information used 
by DSG/3000. The first word returns the call 
status. 
device 6-byte array holding model number and letter for 
graphing device. Must have trailing blank. For 
example: 
7221A 
See Section I for a list of supported devices. 
hptb Integer variable holding the HP-IB address of an 


HP-IB device. The HP-IB address is set on the back 
of the plotting device. (0-32) 
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Parameters (continued) 


copies 


penspeed 


chartype 


If the device is not an HP-IB device, set the 
parameter to -1. 


Integer variable specifying the number of copies to 
be produced. Must be greater than or equal to 0. 


Integer code specifying pen movement speed for 
plotters: 


0 fast (default) 

1 slow 

2 transparency speed (slow, with pauses of 15 
minutes between pen changes to allow ink to 
dry completely. ) 


Integer code specifying character type: 


1 Hardware characters (faster) 
3 Software characters (slower) 
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GERRORMSG 


Returns an error message for the previous error. Callable from all languages. 


FORMAT 
IA BA I I 
GERRORMSG (graf ,msgbuf ,msgbuflen,msglen) 
ifo out in out 
PARAMETERS 
graf Integer array containing global information used 
by DSG/3000. The first word contains the error 
number for which a message will be returned and 
returns the call status. 
msgbuf 72-byte array returning error message. 
msgbuflen Integer variable giving length in bytes of message 
buffer. 
msglen Integer variable giving length in bytes of returned 
message. 
DISCUSSION 


GERRORMSG clears the error flags in the communications area (GRAF) after 
returning the error message. 
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GEXECDATA 


Executes all data specifications set by previous calls to data procedures. 
Required before a chart is drawn (not required for slides). Callable from all 
languages. 


FORMAT 
IA 
GEXECDATA (graf) 
ifo 
PARAMETERS 
graf Integer array containing global information used 
by DSG/3000. The first word returns the call 
status. 
DISCUSSION 


GEXECDATA prepares and manipulates the data for the current chart. If a chart 
is drawn, modified, and drawn again, GEXECDATA prepares the data as necessary 
due to changes. Thus, data preparation is optimized on subsequent calls to 
GEXECDATA. 
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COBOL: 


BASIC: 


FORTRAN: 


SPL: 


PASCAL : 


DATA DIVISION. 
01 


GRAF . 

05 GSTATUS PIC S9(4) COMP. 

OS PARAMETER PIC $9(4) COMP. 

O05 ELEMENT PIC $9(4) COMP. 

05 FILE-ERR PIC $9(4) COMP. 

O05 FILLER PIC S$9(4) COMP OCCURS 1596 TIMES. 


CALL "GEXECDATA" USING GRAF. 
10 REM G IS GRAF ARRAY 


15 REM STATUS IS G[1] 
20 INTEGER G[3700] 


50 CALL GEXECDATA (G[*]) 


INTEGER GRAF (1600) 
INTEGER STATUS 


EQUIVALENCE (STATUS ,GRAF(1)) 


CALL GEXECDATA (GRAF) 


INTEGER ARRAY GRAF (0:1599); 
DEFINE 
STATUS = GRAF (0)#; 


GEXECDATA (GRAF): 


TYPE 
SMALL INT=-32768. .32767,; 
GRAFTYPE =record 


status :small_ int; 
parameter :small_int; 
element :small_ int; 
file err :small_ int; 
graffarea -:array[1..1596] of small_int; 
end; 
VAR 
GRAF :GRAFTYPE ; 


GEXECDATA(GRAF ) ; 
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GEXECHART 


Draws the current chart. Callable from all languages. 


FORMAT 
IA I 
GEXECHART (graf,optimize) 
i/o in 
PARAMETERS 
graf Integer array containing global information used by 
DSG/3000. The first word returns the call status. 
optimize Integer flag indicating whether or not to optimize 


chart production: 
0 Do not optimize 


1 Optimize where possible 
(Not implemented at this time.) 
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DATA DECLARATIONS - GEXECHART 


COBOL: 


BASIC: 


FORTRAN: 


SPL: 


PASCAL : 


DATA DIVISION. 


77 OPTIMIZE PIC $9(4) COMP. 
OL GRAF. 
05 GSTATUS PIC S$9(4) COMP. 
OS PARAMETER PIC S$9(4) COMP. 
O05 ELEMENT PIC $9(4) COMP. 
O05 FILE-ERR PIC $9(4) COMP. 
OS FILLER PIC S$9(4) COMP OCCURS 1596 TIMES. 


CALL "GEXECHART" USING GRAF, OPTIMIZE. 


10 REM G IS GRAF ARRAY O IS OPTIMIZE 
15 REM STATUS IS G[1] 
20 INTEGER G[3700}, O 


50 CALL GEXECHART (G[*],0) 


INTEGER GRAF(1600), OPTIMIZE 
INTEGER STATUS 


EQUIVALENCE (STATUS,GRAF(1)}) 


CALL GEXECHART (GRAF, OPTIMIZE) 


INTEGER ARRAY GRAF (0:1599); 
DEFINE 

STATUS = GRAF (0)#; 
INTEGER OPTIMIZE ; 


GEXECHART (GRAF, OPTIMIZE); 


TYPE 
SMALL_INT=-32768..32767 
GRAF TYPE=record 
status :small_ int; 
parameter:small_ int; 
file_err :small_ int; 
graffarea:small int; 
end; 
VAR 
GRAF :GRAF TYPE ; 
OPTIMIZE:small int; 


GEXECHART (GRAF ,OPTIMIZE); 
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GEXECFIGURE 


Creates a figure in the figure file from the current chart in the current 

chart file as though it were actually being drawn on a device. If the figure file 
does not already exist, it is created at this time. Callable from all 

languages. 


FORMAT 
IA BA BA BA 
GEXECFIGURE (graf ,figurename,figurefile,commentbuf ) 
i/o in in in 
PARAMETERS 
graf Integer array containing global information used by 


DSG/3000. The first word returns the call status. 


figurename 16-byte array containing the name of the figure 
to be created. 


figurefile 36-byte array containing the name of the figure 
file in which the figure will reside. Must be 
36 alphanumeric characters (including lockword, 
group, and account) beginning with an alphabetic 
character. 


commentbuf 128-byte array containing any comment to be 
associated with this figure. 
DISCUSSION 
Figures created by this procedure are stored in a figure file for use by 


other subsystems, such as HPDRAW. All figure information, chart design and data, 
stored in the file. 
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ET 
NQ 


Sets or returns pie chart explosion specifications. Used only with pie charts. 
Callable from all languages. 


GEXPLODE 


FORMAT 
IA BA I 
GEXPLODESET (graf ,explodebuf ,explodelen) 
ifo in in 
IA BA I I 
GEXPLODEINQ (graf ,explodebuf ,explodebuflen,explodelen) 
i/o out in out 
PARAMETERS 
graf Integer array containing global information used by 


DSG/3000. The first word returns the call status. 
explodebuf Byte array holding the explosion specification. 


explodebuflen Integer variable giving length in bytes of 
explosion buffer. 


explodeten Integer variable giving length in bytes of 
explosion specification. 


a) 


DISCUSSION 


Exploding a segment of a pie chart means that it will be drawn slightly 
separated from the rest of the pie. See 2-18 for an example. 


You can specify the segment to be exploded with an expression using relational 
and logical operators listed in Table 7-4. 


Table 7-4. Explosion Expression Operators 


Relational = Equals 
Operators <> Not equal 
> Greater than 
>= Greater than or equal to 
< Less than 
<= Less than or equal to 
Logical not Condition not true 
Operators NOT 
and Both conditions true 
AND 
or At least one condition true 
OR 


The relational operations are performed in the order in which they appear from 
left to right, before logical operators. Logical operations are performed in 
the following order: 


1. NOT 
2. AND BRACKET FOR AND/OR 
OR 
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This means that NOT operations are performed first: and AND and OR operations 
are performed from left to right. This order may be overridden by expressions 
in parentheses whose operations are performed before all others. 


Examples of Explosion Expressions: 
DIVISION="GSD" AND YEAR<1975 
SEX=""M" OR SALARY<2000 

FEMPLOYEES >MEMPLOYEES 


Explosion expressions may include variables from the data file other than the 
independent variable and label variable. 


eae 


SET 
GFONT 


Allows mapping of available fonts to the four fonts which are active at any 
given time. Must be called once for each font selected. 


FORMAT 
IA I BA I I I 
GFONTSET (graf ,fontnumber,fontfile, language,slant,charform) 
ifo in in in in in 
IA I BA I I i 
GFONTINQ (graf,fontnumber, fontfile, language,slant,charform) 
i/o in out out out out 
PARAMETERS 
graf Integer array containing global information used by 


DSG/3000. The first word returns the call status. 


fontnumber (1-4) Integer variable representing the font 
selected. 
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Parameters (continued) 


fontfile 


Language 


36-byte array holding the name of the font file to 
be used. The default fonts presently available in 
the font files are: 


font font description file name 

1 Stick STICK. VCHARSET.SYS 
2 Script SCRIPT .VCHARSET.SYS 
3 Triplex Roman ROMAN. VCHARSET.SYS 
4 Gothic English GOTHIC. VCHARSET.SYS 


Integer variable giving the number of the language 
represented by this font. The default language 

will be one of the available languages and will be 
determined by the message catalog, usually US ASCII. 


Default Language 
US ASCII 
Swedish/Finnish 
Norwegian/Danish 
French 

German 

United Kingdom 
Spanish 


NANI EWNEF O 


In Europe, the message catalog may be changed to 
make the default one of the other available 
languages. 
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Parameters (continued) 


slant Integer variable for slant of characters (italics) 
in this font. (Slant values = -90 to +90 degrees.) 


0 No slant 


charform Integer variable indicating how characters were 
stored--7 bits or 8 bits. 


0 T-bit characters (ASCII) 
1 8-bit characters 


Only 7-bit character value (0) is presently 
supported. 


DISCUSSION 


If GFONTSET is not called, the default mapping is as follows: the default 
language, a 0 slant, and 7-bit characters are used. 


Font 1 Stick 
Font 2 Script 
Font 3 Triplex Roman 
Font 4 Gothic English 
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Additional fonts will be added to the font files at a later time. 


If a font is not available, DSG/3000 finds a font that best matches the one 
specified. Usually it is the Stick font. If a language is not available, the 
default language in the file is used. 


GFONTSET sets the fonts for the current chart only. It will need to be called 


once for each of the font numbers you wish to have activated, if the default 
fonts are not used. 
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GGETCHART 


Accesses a particular chart, making it the current chart. Callable from all 
languages. 


FORMAT 
IA BA 
GGETCHART (graf ,chartname) 
i/o in 
PARAMETERS 
graf Integer array containing global information used by 
DSG/3000. The first word returns the call status. 
chartname 16-byte array holding name of chart. 
DISCUSSION 


In order to access a chart that has been previously created, call GGETCHART 
after opening the chart file. The chart you name in this procedure becomes the 
current chart, meaning that subsequent calls to chart, data and graphing 
procedures refer to this chart. 


If you want to create a new chart, call GCREATECHART instead of 
GGETCHART. 
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DATA DECLARATIONS - GGETCHART 


COBOL: 


BASIC: 


FORTRAN: 


SPL: 


DATA DIVISION. 


O1 GRAF. 
05 GSTATUS PIC S9(4) COMP. 
O05 PARAMETER PIC S$9(4)} COMP. 
O05 ELEMENT PIC S$9(4) COMP. 
OS FILE-ERR PIC S$9(4) COMP. 
OS FILLER PIC a ist COMP OCCURS 1596 TIMES. 


O01 CHART-NAME PIC 


CALL "GGETCHART" USING GRAF, CHART-NAME. 
10 REM G IS GRAF ARRAY C$ IS CHART NAME 
15 REM STATUS IS G[1] 


20 INTEGER G[3700] 
30 DIM C$[16] 


50 CALL GGETCHART (G[*],C$) 
INTEGER GRAF (1600) 

INTEGER STATUS 

CHARACTER* 16 CHARTNAME 


EQUIVALENCE (STATUS,GRAF(1)} 


CALL GGETCHART (GRAF, CHARTNAME) 
INTEGER ARRAY GRAF (0:1599); 
DEFINE 


STATUS = GRAF (O)#; 
BYTE ARRAY CHART’NAME(0:15); 


GGETCHART (GRAF, CHART’ NAME); 


7-63 


PASCAL: TYPE 
SMALL_INT=-32768..32767; 
GRAFTYPE =record 


status :small_ int; 
parameter :small_ int; 
element :small_ int; 
file err :small int; 
graffarea -:array[1..1596] of small_int; 
end; 
VAR 
GRAF :GRAFTYPE: 


F 
CHARTNAME :PACKED ARRAY [1..16] OF CHAR; 


GGE TCHART (GRAF , CHARTNAME ) ; 


7-64 


SET 
GINDVAR 


Sets or returns the X-axis (independent) variable for the current 
chart. Required for all charts but not for slides. Callable 
from all languages. 


FORMAT 
IA BA 
GINDVARSET (graf ,varname) 
i/o in 
IA BA 
GINDVARINQ (graf,varname ) 
i/o out 
PARAMETERS 
graf Integer array containing global information used by 
DSG/3000. The first word returns the call status. 
varname Byte array holding the 16-byte variable name 


identifying the X-axis (independent) variable. 
This may not be a textual variable if a pie chart 
or line chart is being defined. (The data is 

then ignored.) 
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DATA DECLARATIONS - GINDVARSET, GINDVARINQ 


COBOL : DATA DIVISION. 
Ol GRAF. 

05 GSTATUS PIC $9(4) COMP. 

OS PARAMETER PIC S$9(4}) COMP. 

O05 ELEMENT PIC S9(4) COMP. 

O05 FILE-ERR PIC S$9(4) COMP 

OS FILLER PIC S9{(4) 
X(16). 


Ol VAR-NAME PIC 


CALL "“GINDVARSET" USING GRAF, VAR-NAME. 


COMP OCCURS 1596 TIMES. 


BASIC: 1 REM GIS GRAF ARRAY V$ IS VAR-NAME 


REM STATUS IS G[1] 
20 INTEGER G[3700] 
30 DIM V$[16] 


50 CALL GINDVARSET (G[*],V$) 


FORTRAN: INTEGER GRAF (1600) 


INTEGER STATUS 
CHARACTER*16 VARNAME 


EQUIVALENCE (STATUS ,GRAF(1)) 


CALL GINDVARSET (GRAF , VARNAME ) 
SPL: INTEGER ARRAY GRAF(0:1599); 
DEFINE 


STATUS = GRAF (0)#; 
BYTE ARRAY VAR’NAME(0:15); 


GINDVARSET (GRAF, VAR’NAME); 
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PASCAL: PROGRAM DOC; 
TYPE 
SMALL INT=-32768. .32767; 
GRAFTYPE =record 


status :small_ int; 
parameter :small_int; 
element :small_ int; 
file err :small int; 
gebiares :array[1..1596] of small_int; 
end; 
VAR 
GRAF :GRAF TYPE ; 


VARNAME :PACKED ARRAY [1...16] OF CHAR; 


GINDVARSET (GRAF , VARNAME ) ; 
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GINITGRAF 


Initializes communications area. Callable from all languages. 


FORMAT 
IA I I 
GINITGRAF (graf,grafsize, language) 
ifo in in 


CALL "GINITGRAF" USING graf, grafsize, language. 


PARAMETERS 
graf Integer array containing global information used by 
DSG/3000. The first word returns the call status. 
grafsize Integer variable giving length of graf in words. 
Must be at least 1600 words for non-Basic programs 
or 3700 words for Basic programs. 
language Integer code indicating program language: 
0 COBOL 
1 BASIC 
2 FORTRAN 
3 SPL 
4 (Reserved) 
5 PASCAL 
DISCUSSION 


GINITGRAF should be called whenever you enter DSG/3000. Error status is cleared 
and MPE operating system file numbers are set to 0. 


see page 7-3, Communications Area. 
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DATA DECLARATIONS - GINITGRAF 


COBOL : 


BASIC: 


FORTRAN: 


SPL: 


aang 


DATA DIVISION. 


77 GRAFSIZE PIC $9(4) COMP VALUE 1600. 
77 LANGUAGE PIC $9(4) COMP VALUE OQ. 
Ol GRAF. 
05 GSTATUS PIC $9(4) COMP. 
O5 PARAMETER PIC S9(4) COMP. 
OS: -ELEMENT PIC S$9{4) COMP. 
U5.: -RILE=ERR PIC $9(4}) COMP. 
OS FILLER PIC S$9{(4) COMP OCCURS 1596 TIMES. 


CALL "GINITGRAF" USING GRAF, GRAFSIZE, LANGUAGE. 


10 REM G IS GRAF ARRAY S IS GRAFSIZE 
20 REM L IS LANGUAGE 

30 INTEGER G[3700], S, L 

40 $=3500 

50 L=l 


100 CALL GINITGRAF (G[*],S,L) 


INTEGER GRAF (1600) ,GRAFSIZE 
INTEGER STATUS, PARAMETER, ELEMENT, FILERR 


NOTE THAT “LANGUAGE" IS AN IMPLICIT INTEGER 


EQUIVALENCE (STATUS ,GRAF(1i)), (PARAMETER,GRAF(2)) 
EQUIVALENCE (ELEMENT ,GRAF(3)), (FILERR,GRAF (4) ) 


DATA GRAFSIZE/1600/, LANGUAGE/2/ 


CALL GINITGRAF (GRAF, GRAFSIZE, LANGUAGE) 
INTEGER ARRAY GRAF (0:1599); 


DEFINE 
STATUS = GRAF (0)# 
PARAM = GRAF (1)# 
ELEMENT = GRAF (2)# 
FILE’ERR = GRAF (3)#; 
INTEGER GRAFSIZE:=1600, 
LANGUAGE : =3 ; 


GINITGRAF (GRAF, GRAFSIZE, LANGUAGE) ; 
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PASCAL: TYPE 
SMALL INT=-32768..32767; 
GRAFTYPE =record 


status :small_ int; 
parameter :small_ int; 
element :small_ int; 
file err :small int; 


graffarea ‘array[l..1596] of small_int; 
ae END;(* RECORD *) 
V 


GRAF :GRAF TYPE ; 
GRAFSIZE, 
LANGUAGE :SMALL_INT; 


GINITGRAF (GRAF , GRAFSIZE , LANGUAGE) ; 
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GLABEL 
INQ 


Sets or returns labels for major tick marks in bar and line graphs or segments 
in pie graphs. Provides for dynamic labeling. Callable from all languages. 


FORMAT 
IA I I BA I I 
GLABELSET (graf,axis,type,labelbuf,labelen,numlabels, 
i/o in in in in in 
I IA 
labelspacing,useroptions) 
in in 
IA I I BA I I 
GLABELINQ (graf,axis,type,labelbuf,labelbuflen,labelen, 
ifo in out out in out 
I I IA 
numlabels,labelspacing,useroptions) 
out out out 
PARAMETERS 
graf Integer array containing global information used by 
DSG/3000. The first word returns the call status. 
axis Integer code indicating what is to be labeled: 
1 X axis 
2 Y axis 


3 Pie segments 


TT 


type 


label buf 


label buflen 


tabelen 


numLabets 


Label spacing 


Integer code indicating where labels are to be 
found: 


0 no labels 


1 data variable contains labels (pies and bars 
only); not valid for dependent axis 


2 calculate labels from axis scaling (bars and 
lines only) 


3 dynamic labeling (described by the three 
following parameters) 


Byte array holding list of dynamically supplied 
labels. A single label can be at most 25 
characters. Maximum buffer size is 650 characters. 


Integer variable giving length in bytes of the 
buffer to receive the labels. 


Integer variable specifying length in bytes of one 
label. Must be a positive number, no greater than 
25. (Ignored if labels are not dynamically 
supplied. ) 


Integer variable specifying number of labels in the 
label buffer. (Ignored if labels are not 
dynamically supplied.) Must be positive. 


Integer variable specifying number of major ticks 
per label: 


1 label every major tick 


2 label every other major tick 
n label every nth major tick 


T-Te2 


Parameters (continued) 


useroptions Integer array 2 words in length used as comments 
field for interactive interface. Ignored by the 
intrinsics, but used by the interactive program 
GRAPH as follows: 

Byte 1 numeric (calculate labels) 

data has labels 

weekdays 

months 

quarters 

years 


—~ORzLOVS 


Byte 2 abbreviated 


full 


'] > 


Bytes 3 & 4 Any integer start value 


DISCUSSION 
Bar chart: page 6-12 


Line chart: page 6-19 
Pie chart: page 6-23 
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DATA DECLARATIONS - GLABELSET, GLABELINQ 


COBOL : DATA DIVISION. 
Ol GRAF. 
05 GSTATUS PIC 
OS PARAMETER PIC 
OS ELEMENT PIC 
05 FILE-ERR PIC 
OS FILLER PIC 
Ol X-AXIS-LABELS. 
0S AXIS PIC 
05 LTYPE PIC 
O05 LABEL-BUF. 
10 LABEL1 PIC 
10 LABEL2 PIc 
10 LABEL3 PIC 
10 LABEL4 PIC 
OS LABELEN PIC 
05 NUM-LABELS PIC 
05 LABEL-SPACING PIC 


05 USER-OPTIONS PIC 


COMP OCCURS 1596 TIMES. 


COMP VALUE 
COMP VALUE 


L, 

3. 

VALUE "WEEK 1" 

VALUE "WEEK 2". 
VALUE “WEEK 3". 
VALUE "WEEK 4". 
} COMP VALUE 8. 
} COMP VALUE 4. 
}) COMP VALUE 1. 
) COMP OCCURS 2 TIMES. 


CALL "GLABELSET" USING GRAF, AXIS, LTYPE, LABEL-BUF, 
LABELEN, NUM-LABELS, 
LABEL-SPACING, USER-OPTIONS. 


BASIC: 10 REM G IS GRAF ARRAY 
20 REM T IS TYPE 
30 REM Li IS LABELEN 


A IS Axis 
L$ IS LABEL-BUF 
N IS NUM-LABELS 


40 REM L2 IS LABEL-SPACING U IS USER-OPTIONS 


50 REM 


60 INTEGER G[3700],A,T,L1,N,L2,U[2] 


70 DIM L$[32] 


80 A=l1 

90 T=3 
100 L$(1)="WEEK 1 “ 
110 L$(9)="WEEK 2 " 
120 L$(17)="WEEK 3 “ 
130 L$(25)="WEEK 4 " 
140 L1=8 

150 N=4 

160 L2=1 
170 MAT U=ZER 


200 CALL GLABELSET(G[*],A,T,L$,L1,N,L2,U[*]) 
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FORTRAN: 


SPL: 


INTEGER GRAF(1600), AXIS, TYPE 
CHARACTER*8 LABELBUF (4) 

INTEGER LABELEN, NUMLABELS, LABELSPACING 
INTEGER USEROPTIONS(2)} 

DATA USEROPTIONS/2*0/ 


AXIS=1 

TYPE=3 

LABELBUF(1)="WEEK 1" 

LABELBUF (2)="WEEK 2" 

LABELBUF(3)="WEEK 3" 

LABELBUF(4})="WEEK 4" 

LABELEN=8 

NUMLABELS=4 

LABELSPACING=1 

CALL GLABELSET (GRAF, AXIS, TYPE, LABELBUF, 


* 


LABELEN, NUMLABELS, LABELSPACING, 
@ USEROPTIONS) 


INTEGER ARRAY GRAF (0:1599); 


INTEGER AXIS:=1, 
TYPE: =3, 
LABELEN: =8, 
NUM’ LABELS: =4, 
LABEL’ SPACING: =1: 
BYTE ARRAY LABEL’ BUF (0: 31):=32(" "); 
INTEGER ARRAY USER’OPTIONS(O: 1):=2(0); 


MOVE LABEL’ BUF 


(O):="WEEK 1"; 
MOVE LABEL ’ BUF (8) := "WEEK aoe 
MOVE LABEL’ BUF(16):="WEEK 3": 


MOVE LABEL’ BUF(24):="WEEK 4": 

GLABELSET (GRAF, AXIS, TYPE, LABEL’ BUF , 
LABELEN, NUM’ LABELS, LABEL’ SPACING, 
USER OPTIONS) ; 
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PASCAL CONST 


NO_LABEL 

DATA VAR_CONTAINS 
CALCULATE 
DYNAMIC 


TYPE 
SMALL_INT=-32768. .32767; 
USER OPTION REC=RECORD 
optn_array :packed array[1..2] of char; 
start value :small_ int; 
END:(* USER OPTION REC*) — 
GRAFTYPE =record | 
status, 
parameter, 
element , 
file err, :small int 
raffarea :array[1..1596] of small_int; 


WN O 


END;(* GRAFTYPE *) 

LABEL_TYPE =PACKED ARRAY[1..8] OF CHAR; 
VAR 

AXIS, 

ELPE.; 

LABEL_LEN, 

NUM LABELS, 

LABEL _SPACING :SMALL_INT 

GRAF :GRAFTYPE ; 

LABEL_BUF :PACKED ARRAY OF [1..4] OF LABEL_TYPE 

USER_OPTIONS :USER_OPTION_REC; 


GLABELSET(GRAF ,AXIS, TIPE,LABEL BUF ,LABEL LEN, 
NUM_ LABELS, LABEL _ SPACING, USER _OPTIONS) ; 
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GLABVAR 


sets or returns the label variable. Used by pie and bar charts. Callable from 
all languages. 


FORMAT 
TA BA 
GLABVARSET (graf ,varname) 
i/o in 
IA BA 
GLABVARINQ (graf ,varname) 
ifo out 
PARAMETERS 
graf Integer array containing global information used by 
DSG/3000. The first word returns the call status. 
varname Byte array holding 16-byte data variable name 
identifying the label variable. 
DISCUSSION 


Pie charts: page 6-23. 
Bar charts: page 6-12. 


eT 


GLEGEND 


Sets or returns color, texture, and legend labels for a dependent variable in a 
line or bar chart. Callable from all languages. 


FORMAT 
IA I I I I BA 
GLEGENDSET (graf,depvarid,color,texture,marker, legend1 
i/o in in in in in 
BA I 
legend2,useroptions) 
in in 
IA I I I I BA 
GLEGENDINQ (graf ,depvarid,color,texture,marker, legend1 
i/o in out out out out 
BA I 
legend2,useroptions) 
out out 
PARAMETERS 
graf Integer array containing global information used by 
DSG/3000. The first word returns the call status. 
depvarid Integer variable specifying the relative number of 


the Y-axis variable being described. The first y 
axis (dependent) variable named in GDEPVARSET is 
numbered one. 
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Parameters (continued) 


color 


texture 


marker 


legendi 


Integer code corresponding to the color assigned to 
the variable (1-16): 


1 color of pen 1, usually black 

2 color of pen 2, usually red 

3 color of pen 3, usually green 

4 color of pen 4, usually blue 
5...16 if additional pens are used. 


This parameter is ignored if the plotting device is 
a non-color device. The default, specified as 0 
or -1, is black. Appendix A contains information 
about colors. 


Integer code corresponding to the texture assigned 
to the variable. For scattergrams, equate 

texture to 0. The default, specified as -1, 
assigns a different texture to each variable. 

See Appendix A. 


Integer code corresponding to the marker type 
assigned to the variable. Each data point on the 
line will be marked with this symbol. Ignored for 
bar graphs. 


Scattergrams must be given a non-zero value. The 
default, specified by 0 or -1, is no markers. See 
Appendix A. 


Byte array holding the first line of the legend 
text; 18 characters in length. 


C19 


Parameters (continued) 


legend2 Byte array holding the second line of the legend 
text; 18 characters in length. 


useroptions Integer variable used as comments field. Ignored 
by procedure. 


DISCUSSION 


Each Y-axis (dependent) variable is associated with a line on a line chart or a 
set of bars on a bar chart. Each of these lines or bar sets is numbered 
(depvarid) in the order in which they were specified in GDEPVARSET. 


When you plot more than one dependent variable, DSG/3000 gives each one a 
different texture by default, as shown in Appendix A. Call GLEGENDSET to change 
the texture or add colors and data markers. Note that GLEGENDSET is called 

once for each variable. 


Legends are drawn under the title of the graph and are used to associate a 
variable with a particular color and texture. The text of each legend can take 
up to two lines (legendi1 and legend2), each containing 18 characters. If 

only one line of legend is used, leave line 1 blank and enter the text on line 2 
for the best visual effect. 


Scattergrams are a special type of line graph having markers but no connecting 
lines (texture=0). 
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DATA DECLARATIONS - GLEGENDSET 
DATA DIVISION. 


COBOL : 


BASIC: 


O1 


O1 


GRAF . 

05 GSTATUS PIC S9{ 
OS PARAMETER PIC S$9[ 
OS ELEMENT PIC S9{ 
O05 FILE-ERR PIC S9[ 
O05 FILLER PIC S9( 
VARIABLE-ONE . 

O05 DEP-VAR-ID PIC S9( 
O05 COLOR. PIC S$9([ 
05 TEXTURE PIC S9( 
O5 MARKER PIC S$9{ 
O05 LEGEND1 PIC X(1 
05 LEGEND2 PIC X{1 
O05 USER-OPTIONS PIC S9{ 


LPOoOHPAPHhHh HPLahAhHh 
eee? See! Sa See! Sree Seer! Sree ee Non See See Sree 


COMP. 
COMP. 
COMP . 
COMP. 


COMP 


COMP 
COMP 
COMP 
COMP 


VALUE 
VALUE 


COMP 


OCCURS 1596 TIMES. 


VALUE 1. 
VALUE 2. 
VALUE 6. 
VALUE O. 
"LINE 1 TEXT". 
"LINE 2 TEXT". 
VALUE O. 


CALL "GLEGENDSET" USING Sei DEP-VAR-ID, COLOR, 


200 


CrrereEBenoocvOornanaanyw 


EXTURE , 
LEGEND2, 

EM G IS GRAF ARRAY 

EM C IS COLOR 

EM M IS MARKER 

eG L2$ IS LEGEND2 

NTEGER G[3700] ,D,C,T,M,U 

a L1$[18],L2$[18 

=2 

=6 

=Q 

1$="LINE 1 TEXT" 

2$="LINE 2 TEXT" 

=0 


MARKER, LEGEND1, 
USER-OPTIONS. 


D IS DEP-VAR-ID 

T IS_TEXTURE 

Lig IS LEGEND1 

U IS USER-OPTIONS 
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“CALL GLEGENDSET (G[*],D,C,T,M,L1$,L2$,U) 


FORTRAN: 


SPL: 


INTEGER GRAF (1600), DEPVARID, COLOR 
INTEGER TEXTURE, MARKER, USEROPTIONS 
CHARACTER*18 LEGEND1, LEGEND2 


DEPVARID=1 

COLOR =2 

TEXTURE =6 

MARKER =0 
LEGENDI1="LINE 1 TEXT" 
LEGEND2="LINE 2 TEXT" 
USEROPTIONS=0 


(CALL GLEGENDSET (GRAF, DEPVARID, COLOR, TEXTURE, 


MARKER, LEGEND1, LEGEND2, 
USEROPTIONS ) 


INTEGER ARRAY GRAF (0:1599); 
INTEGER DEP’VAR’ID:=1, 
COLOR: =2, 
TEXTURE: =6, 
MARKER: =0, 
USER OPTIONS: = 
BYTE ARRAY LEGEND1(0 
BYTE ARRAY LEGEND2(0 


0; 
717) :=18[ 
:17):=18(" "); 


MOVE LEGEND1:="LINE 1 TEXT"; 
MOVE LEGEND2:="LINE 2 TEXT": 


GLEGENDSET (GRAF, DEP’VAR’ID, COLOR, TEXTURE, 
MARKER, LEGEND1, LEGEND2, USER’OPTIONS) ; 
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PASCAL 


CONST 


BLANK 

DOTTED 

DASHED 

LINED 

CROSSHATCHED 

TIGHT LINED 

TIGHT CROSSHATCHED 
SOLID 


NONE 
ASTRIC 
CROSS 
TRIANGLE 
SQUARE 
DIAMOND 
CIRCLE 
Chere Ok 


CO™~ OD) UT Pa CO NDR 


Hott bin 
CON MDURWNERO 


YPE 
SMALL_INT=-32768. .32767 ; 


GRAFTYPE =record 
status, 
parameter, 
element , 
file err, 
gear tares, 

END: (* GRAFTYPE *) 


PEN NUM_TYPE =1..8; 


VAR 


LEGEND1, 

LEGEND2 :PACKED ARRAY [1...18] OF CHAR 
DEPVARID, 

USER_OPT, 

MARKER , 

TEXTURE :SMALL_INT ; 

GRAF :GRAFTYPE ; 

PEN NUM :PEN NUM_TYPE; 


GLEGENDSET(GRAF ,DEPVARID, PEN _NUM, TEXTURE , MARKER, 
LEGEND1 , LEGEND2 ,USER_OPT) ; 
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GLIMIT [A] a 


Sets or returns the position of a chart on the plotting device. The ASCII 
version, callable from COBOL as well as other languages, is designated by an "A 
in the procedure name. 


FORMAT 


IA I R R R R 
GLIMITSET (graf,limits,x1l,y1,x2,y2) 
ifo in in in in in 
IA I R R R R 
GLIMITINQ (graf,limits,x1l,y1,x2,y2) 
ifo out outoutoutout 


CALL "“GLIMITASET" USING graf,limits,x1l,y1,x2,y2 


CALL "GLIMITAINQ" USING graf,limits,xl,y1,x2,y2 


PARAMETERS 

graf Integer array containing global information used by 
DSG/3000. The first word returns the call status. 

limits Integer flag indicating whether the following 


coordinates refer to inner or outer limits: 


0 default for the device. Usually approximates 8 
1/2 inch by 11 inch format (D-size paper on 7580 and 7585) 


1 chart boundary (outer limits) 
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Parameters (continued) 


x1 


yl 


x2 


y2 


2 data boundary (inner limits) 

3 English standard (8 1/2 by 11 inch format) 

4 Metric standard (210 mm by 298 mm) 

Option 2 not applicable for pie charts or slides. 
ASCII version: 16-byte array 

REAL version: real variable 


X-coordinate (horizontal position) of lower left 
corner. 


ASCII version: 16-byte array 
REAL version: real variable 


Y-coordinate (vertical position) of lower left 
corner. 


ASCII version: 16-byte array 
REAL version: real variable 


X-coordinate (horizontal position) of upper right 
corner. 


ASCII version: 16-byte array 
REAL version: real variable 


Y-coordinate (vertical position) of upper right 
corner. 
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DISCUSSION 
See page 6-7/8. 


Note: If you accept the default or the English or Metric standard for this 

procedure, the graph is always drawn to fit the format of the plotting device. 
If you specify limits and later change plotting devices, you may also need to 
change the limit specifications so that you will not lose a part of the graph. 


To use non-standard paper with a plotter, position the paper a few 


millimeters to the right of the lower left plotter bed. This applies to the use 
of HP transparencies and paper shorter than 11 inches. 
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GLISTCHARTS 


Returns a list of chart names from the chart file directory. Callable from all 
languages. 


FORMAT 
TA BA I if I 
GLISCHARTS (graf,chartnames ,maxcharts,firstchart ,numcharts) 
i/o out in in out 
PARAMETERS 
graf Integer array containing global information used by 
DSG/3000. The first word returns the call status. 
chartnames Byte array returning 16-byte chart names from the 
current chart file. 
maxcharts Integer variable specifying the maximum number of 
charts to be returned. 
firstchart Integer variable specifying the first chart name to 
be returned. Charts are numbered in the order 
created, starting with 1. 
numcharts Integer variable specifying the number of charts 
returned. 
DISCUSSSION 


GLISTCHARTS can return the names of some or all of the charts in 
the chart file, functioning like a table of contents. 
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GNUMCHARTS 


Returns the total number of charts in chart file. Callable from 
all languages. 


FORMAT 
TA I 
GNUMCHARTS (graf,numcharts) 
i/o out 
PARAMETERS 
graf Integer array containing global information used by 
DSG/3000. The first word returns the call status. 
numcharts Integer variable specifying number of charts in 


current chart file. 
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GOPENFILE 


Opens an existing chart file. Callable from all languages. 


FORMAT 
IA BA I 
GOPENFILE (graf,filename,access) 
ifo in in 
PARAMETERS 
graf Integer array containing global information used by 
DSG/3000. The first word returns the call status. 
filename 36-byte array containing name of file being opened. 
Can be fully qualified. Must be terminated by a 
space (blank character). 
access Integer flag indicating whether to open file with 


exclusive or shared access: 


1 exclusive access 
2 shared access 


If you supply a 0, the default results in exclusive 
access. 
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DISCUSSION 


A call to GOPENFILE establishes the named file as the current chart file. Only 
charts contained in this file can be subsequently accessed. This procedure 
places the MPE file number in GRAF, the communications buffer, and closes any 
previously opened chart file. 


Any writing or creating activity must access the file exclusively. Inquiring, 
executing, opening, and getting charts are sharable activities. 


DATA DECLARATIONS - GOPENFILE 


COBOL : DATA DIVISION. 
O1 GRAF 
05 GSTATUS PIC $9(4) COMP 
05 PARAMETER PIC $9(4) COMP 
O05 ELEMENT PIC $9(4) COMP. 
OS FILE-ERR PIC $9(4) COMP. 
O05 FILLER PIC S9(4} COMP OCCURS 1596 TIMES. 
Ol CHART-FILE-INFO. 
OS FILE-NAME PIC X(36) VALUE “OLDCHART ". 
05 GACCESS PIC $9(4) COMP VALUE 1. 


BASIC: 10 REM G IS GRAF ARRAY FS IS CHART FILE NAME 
20 REM A IS FILE ACCESS 
25 REM STATUS IS G{1] 
30 INTEGER G[3700], A 
40 DIM F$[36] 
50 F$="OLDCHART " 


80 CALL GOPENFILE (G[*],F$,A) 


7-90 


FORTRAN: 


SPLe 


PASCAL : 


Cc 


INTEGER GRAF(1600), STATUS, ACCESS 
CHARACTER*36 FILENAME 


EQUIVALENCE (STATUS, GRAF (1) ) 
FILENAME="OLDCHART “ 


CALL GOPENFILE (GRAF, FILENAME, ACCESS) 


INTEGER ARRAY GRAF (0:1599); 
DEFINE 
STATUS = GRAF (0)#; 
BYTE ARRAY FILE ’NAME(0:35):="OLDCHART “; 
INTEGER ACCESS: =1; 


GOPENFILE (GRAF, FILE’NAME, ACCESS); 


TYPE 
SMALL INT=-32768..32767; 
GRAFTYPE =record 


status :small_ int; 
parameter :small_ int; 
element :small_ int; 
file_err :small_int; 
sont rates :array[1..1596] of small_int; 
end; 
VAR 
GRAF :GRAFTYPE ; 


FILENAME :PACKED ARRAY [1...36] OF CHAR; 
ACCESS :SMALL_INT; 


GOPENF ILE (GRAF , F ILENAME , ACCESS) ; 
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SET 
NQ 


Sets or returns unique pie chart characteristics. Callable from all languages. 


GPIE 


FORMAT 


IA I I IA I IA 
GPIESET (graf ,percent,actual,colorbuf,colorlen,texturebuf, 
ifo in in in in in 


I 
texturelen) 
in 


IA I I IA I I 
GPIEINQ (graf,percent ,actual,colorbuf,colorbuflen,colorlen, 
ifo out out out in out 


IA I I 


texturebuf ,texturebuflen,texturelen) 
out in out 


PARAMETERS 


graf Integer array containing global information used by 
DSG/3000. The first word returns the call status. 


percent Integer flag indicating whether to label each 
segment with percentages: 


O do not label percentages (default) 
1 label percentages 
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Parameters (continued) 


actual 


colorbuf 


colorbuflen 


texturebuf 


texturebuflen 


Integer flag indicating whether to label each 
segment with its actual data value: 


0 do not label (default) 
1 label with actual data value 


Integer array holding colors of segments by 
relative position. The first segment begins in the 
two o'clock position, and the buffer is circular. 
Maximum number of colors is 30. Valid colors are: 


1 color of pen 1, usually black 

2 color of pen 2, usually red 

3 color of pen 3, usually green 

4 color of pen 4, usually blue 
5...16 if additional pens are used. 


This parameter is ignored if the plotting device 

is a non-color device. The default color, 

specified as 0 or -1, is usually black. See Appendix 
A for additional color information. 


Integer variable specifying the length in words of 
the colors buffer. 


Integer array holding textures of segments by 
relative position. The first segment is drawn 
beginning in the two o'clock position, and the 
buffer is circular. Maximum number of textures is 
30. See appendix A for textures. 


Integer variable specifying length in words of 
textures buffer. 
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Parameters (continued) 


cotorlen Integer variable specifying number of colors in 
colorbuf . 

texturelen Integer variable specifying number of textures in 
texturebuf. 

DISCUSSION 


If you want the segments to be drawn clockwise from smallest to largest, you 
must call GSORTSET. Otherwise, the segments are drawn in the order they appear 
in the data file. 


Since the colors and textures buffers are circular, if you specify fewer colors 
or textures than there are segments, the assignment of colors and textures will 
be repeated. For example, if for 8 segments you specify the colors red, green, 
and blue, the segments will be drawn in the following colors: 


Segment Color 


red 
green 
blue 
red 
green 
blue 
red 
green 


ON AU EWN bP 


See page 6-26 for a discussion of segment labeling. 
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GREADANOT[A] 


Used for positioning annotations. Reads graphics cursor and returns its 
coordinates in relative units. The ASCII version, callable from COBOL as well 
as other languages, is designated by an "A" in the procedure name. 


FORMAT 
TA R R 
GREADANOT (graf, x, y) 


i/o out out 


CALL "GREADANOTA" USING graf, x, y 


PARAMETERS 
graf Integer array containing global information used by 
DSG/3000. The first word returns the call status. 
x ASCII version: 16-byte array 
REAL version: real variable 
X-coordinate (horizontal position) of graphics 
cursor. 
y ASCII version: 16-byte array 
REAL version: real variable 
Y-coordinate (vertical position) of graphics 
cursor. 
DISCUSSION 


A call to GREADANOT[A] digitizes a point after the user positions the graphics 
cursor and presses any character key. 


See pages 6-9 for a discussion of annotations. 
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SE 
GSORT 


Sets or returns a flag to sort the independent variable. Callable from all 
languages. 


FORMAT 
TA I 
GSORTSET (graf,sortflag) 
i/o in 
IA I 
GSORTINQ (graf,sortflag) 
ifo out 
PARAMETERS 
graf Integer array containing global information used by 
DSG/3000. The first word returns the call status. 
sortflag Integer flag indicating whether to sort the X-axis 


(independent) variable: 


O no sort (default) 
1 sort 
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DISCUSSION 


This procedure is applicable to all graph types. The default is that the data 
is plotted in the order it appears in the data file. If you set the sort flag, 
the data is drawn in increasing numeric order or, if the X-axis variable is 
textual, in alphabetic order. In the case of bar graphs, this affects the order 
of the bars in the completed graph. 


When you are designing a pie chart, the segments are drawn in the order of the 


data in the data file. Call GSORTSET if you want the segments to be drawn 
clockwise from smallest to biggest starting at the two o'clock position. 
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SET 
INQ 


GSUB 


Sets or returns data file subset specifications. Callable from all languages. 


FORMAT 
IA BA I 
GSUBSET (graf,subsetbuf ,subsetlen) 
i/o in in 
IA BA I I 
GSUBINQ (graf,subsetbuf,subsetbuflen,subsetlen) 
i/o out in out 
PARAMETERS 
graf Integer array containing global information used by 
DSG/3000. The first word returns the call status. 
subsetbuf Byte array holding subset specifications. (See 
Table 3-2.) 
subsetlen Integer variable specifying length in bytes of 


subset specifications. 


subsetbuflen Integer variable specifying maximum numbers of 
bytes to be returned in the subset buffer. A 
warning is returned if the buffer is too small to 
receive the subset. 
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DISCUSSION 


Subsets specify which items from the data file will be plotted. Subsets are 
described using relational and logical operators. See page 3-15. 


The parameter subsetlen may be retrieved before calling GSUBINQ by calling 
GDATAINFO. 
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GSUPPRESS 
NQ 


Sets or returns the graph components that will not be drawn. Callable from all 
languages. 


FORMAT 
IA I I I I I I 
GSUPPRESSSET (graf,chart,legends,labels,axes,title,frame, 
i/o in in in in in in 
I I 
data,advance) 
in in 
IA I I I I I I 
GSUPPRESSINQ (graf,chart,legends,labels,axes,title,frame, 
ifo out out out out out out 
I I 
data,advance) 
out out 
PARAMETERS 
graf Integer array containing global information used by 


DSG/3000. The first word returns the call status. 
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Parameters (continued) 


chart 


legends 


labels 


axves 


title 


Integer flag indicating whether the chart 
attributes should be suppressed: 


0 draw chart (default) 
1 suppress chart 


Chart attributes include legends, labels, axes, 
titles, frame, data, and advance. 


Not included are data, represented by bars, 
lines or pie segments. 


Integer flag indicating whether the legends should 
be suppressed: 


0 draw legends (default) 
1 suppress legends 


Integer flag indicating whether the labels should 
be suppressed: 


0 draw labels (default) 
1 suppress labels 


Integer flag indicating whether the axes should be 
suppressed: 


O draw axes (default) 
1 suppress axes 


Integer flag indicating whether the titles should 
be suppressed: 


0 draw titles (default) 
1 suppress titles 
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Parameters (continued) 


frame Integer flag indicating whether the frame should be 
suppressed: 


O draw frame 
1 suppress frame (default) 


data Integer flag indicating whether the data should be 
suppressed: 


O draw data (default) 
1 suppress data 


Data includes bars, lines and pie segments. 


advance Integer flag indicating whether the paper advance 
should be suppressed: 


0 advance paper (default) before drawing chart 
1 do not advance 


DISCUSSION 


Call GSUPPRESSSET if you want to overlay charts or parts of charts. The advance 
parameter affects the graphics terminals (2623A,2647A,2647F, 2648A and 2703) as w 
as the scrolling plotters (7221S/T,9872S/T and 7220S/T). If you suppress the 
advance, the video display will not clear, and the current graph will overlay 

the previous chart. 


7-102 


GSYMBOL[A] 
NQ 


Sets or returns box, line, or arrow annotations. The ASCII version, callable 
from COBOL as well as other languages, is designated by an "A’ in the procedure 
name. 


FORMAT 
IA ai I R R R R 
GSYMBOLSET (graf,annotid,symbol,xl, yl, x2, y2 
i/o in in in in in in 
I I 
color,linetype) 
in in 
TA I E R R R _ R 
GSYMBOLINQ (graf,annotid,symbol,x1, yl, x2, y2 
i/o in out out out out out 
I I 
color, linetype) 
out out 


CALL "GSYMBOLASET" USING graf anotnum symbol x1 yl x2 y2 
color linetype 


CALL "GSYMBOLAINQ" USING graf anotnum symbol x1 yl x2 y2 
color linetype 
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PARAMETERS 


graf 


annotid 


symbol 


v1 


yl 


<2 


Integer array containing global information used by 
DSG/3000. The first word returns the call status. 


Integer variable specifying the unique annotation 
identifying number. The first annotation is 
numbered one. 


Integer code specifying the type of annotation 
symbol: 


1 box 
2 arrow 
3 line 


ASCII version: 16-byte array 
REAL version: real variable 


x-coordinate for one end of the line, the head of 
the arrow, or one corner of the box. The value of 
the x-coordinate can range from 0 to 100. 


ASCII version: 16-byte array 
REAL version: real variable 


y-coordinate for the same point described by x2. 
The value of the y-coordinate can range from 0 to 
100. 


ASCII version: 16-byte array 
REAL version: real variable 


x-coordinate for the other end of the line, the 
tail of the arrow, or the diagonally opposite 
corner of the box. The value of the x-coordinate 
can range from 0 to 100. 
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Parameters (continued) 


y2 


color 


Linetype 


ASCII version: 16-byte array 
REAL version: real variable 


y-coordinate for the same point described by x2. 
The value of the y-coordinate can range from 0 to 
100. 


Integer code specifying the color of the annotative 


1 color of pen 1, usually black 
2 color of pen 2, usually red 

3. color of pen 3, usually green 
4 color of pen 4, usually blue 
» 


...16 if additional pens are used. 


This parameter is ignored if the plotting device is 
a non-color terminal or plotter. The default 
color, specified as 0 or -1, is black. 


Integer code specifying the texture of the lines 
making up the annotative symbol. To use the 
default, which is a solid line, supply a -1. 

A 0 represents no texture (no annotation). To 
specify textures enter 1-8. See Appendix A for 
table of line textures. 
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DISCUSSION 

Call GSYMBOL[A]SET once for each annotation. For text annotations, call 
GTEXT[A]SET. The coordinates of each annotation should be determined by calling 
GREAD [A] ANOT. 


For dynamic digitizing call GREADANOT twice and pass the returned coordinates on 
to GSYMBOLSET. 


See page 6-9. 


GSYMBOL[A]SET draws the annotations on the current graphing device; GSYMBOL[A] INQ 
moves the graphics cursor to the x21,yi coordinate. 
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GTERMGRAF 


Terminates access to DSG/3000 and closes any open chart files. Callable from 
all languages. 


FORMAT 
IA 
GTERMGRAF (graf) 
i/o 
PARAMETERS 
graf Integer array containing global information used 
by DSG/3000. The first word returns the call 
status. 
DISCUSSION 


GTERMGRAF will call GCLOSEFILE if any chart files are still open. It also 
closes internal DSG/3000 files. 
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ET 
NQ 


Sets or returns a text annotation. The ASCII version, callable from COBOL as 
well as other languages, is designated by an "A" in the procedure name. 


GTEXT[A] 


FORMAT 
IA iE R R I I I I 
GTEXTSET (graf,annotid,x1, y1, lorg,angle,color,charsize, 
i/o in in in in in in in 
BA I 1 
textbuf,textlen, font) 
in in in 
IA I R R I I I I 
GTEXTINQ (graf,annotid,x1, yl, lorg,angle,color,charsize, 
i/o in out out out out out out 
BA I I I 
textbuf, textbuflen,textlen, font) 
out in out out 


CALL "GTEXTASET" USING graf annotid x1 yl lorg angle color 
charsize textbuf textlen font 


CALL "“GTEXTAINQ" USING graf annotid x1 yl lorg angle color 
charsize textbuf textbuflen textlen font 
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PARAMETERS 


graf Integer array containing global information used by 
DSG/3000. The first word returns the call status. 


annotid Integer variable specifying the unique annotation 
identifying number. Annotation numbers must be 


non-negative. 


x1 ASCII version: 16-byte array 
REAL version; real variable 


x-coordinate of the digitized point. 


yl ASCII version: 16-byte array 
REAL version: real variable 


y-coordinate of the digitized point. 


lorg Integer code specifying the label origin: 
1 lower left 6 upper middle 
2 middle left 7 lower right 
3 upper left 8 middle right 
4 lower middle 9 upper right 
5 middle middle 


The label origin tells DSG/3000 which part of the text string should be 
positioned at the digitized point (xl,y1). Figure 7-1 shows an example of a 
text string and the locations of the cursor that can be specified. 
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(Ut) (UM) 


TTTTTTTTTTTTT EEEEEEEEEEE XXX XXX TTTTTTTTTTTTT 
TTTTTTTTTTTTT EEEEEEEEREE XXX XXX TTTTTTTTTTTTT 
TTT EEE XXX XXX TTT 
TTT EEE XXX XXX TTT 
TTT EEE XXX XXX TTT 
gb EEEEEE (MM) XXXXX TTT 
TTT EEE XXX XXX TTT 
TTT EEE XXX XXX TTT 
ied bd EEE XXX XXX TTT 
TTT EEEEEEEEEEE XXX XXX TTT 
TTT EEEEEEEEEEE XXX XXX TTT 


(LM) 


Label origin codes: 


UL Upper Left Upper Middle Upper Right 
ML Middle Left Middle Middle Middle Right 
LL Lower Left Lower Middle Lower Right 





Figure 7-1. Position of Label Origin with Respect 
to Text Annotation 
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Parameters (continued) 


angle 


color 


charsize 


textbuf 


textlen 


font 


textbuflen 


Integer variable ranging from 0 through 359 
specifying the angle at which the text is to be 
placed. 


Integer code specifying the color of the 
annotation: 


1 color of pen 1, usually black 

2 color of pen 2, usually red 

3 color of pen 3, usually green 

4 color of pen 4, usually blue 
5...16 if additional pens are used. 


This parameter is ignored if the plotting device is 
a non-color plotter or terminal. The default 
color, specified as 0 or -1, is black. See 
Appendix A for additional color information. 


Integer variable specifying the relative character 
size, from 1 (smallest) to 72 (biggest). See 
Appendix A for examples of sizes. 


Byte array holding the text string. Maximum length 
is 100 bytes. May contain special text string 

(see below). 

Integer variable specifying length of text string. 
Integer code specifying pre-established font types. 
Maximum of 4 fonts accepted for a single chart. 


Enter 1-4. Default=1 (usually Stick font). See GFONTSET. 


Integer variable specifying the length of the 
buffer holding the text string. 


Tilt 


DISCUSSION 

Call GTEXT[A]SET once for each text annotation. Other annotations are set by 
calling GSYMBOL[A]SET. The coordinates should be determined by calling 
GREADANOT[A]. (See page 6-9.) 


GTEXT[A]SET draws the text annotation on the screen: GTEXT[A]INQ moves the 
graphics cursor to the digitized point (x1,y1). 


Four type fonts may be active for a single chart. They are established through 
GFONTSET, which allows you to map the fonts you have selected to a font number. 


Special Character Strings 


A text annotation can contain any of the following special strings: 


$TODAY Represents the current date in the form mm/dd/yy 
with leading zeros suppressed. For example, 
9/16/82. 

$MONTH Represents the current month spelled out in full. 


For example, SEPTEMBER. 


$M Represents the current month numerically. For 
example, 9. 
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$DAY Represents the current numeric day of the month. 
For example, 15. 


$YEAR Represents the current year in 4 digits. For 
example, 1982. 


$Y Represents the current year by its last two digits. 
For example, 82. 


Here is an example of a text annotation with a special string 
embedded: 


HIGHEST SALES VOLUME AS OF $TODAY. 


<————— HIGHEST SALES VOLUME AS OF 8/14/80 











Figure 7-2. Annotation with Special Character String 
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GTEXTCONTROL 


Allows for specification of size, color, and font for legends, labels, and 
titles. Callable from all languages. 


FORMAT 
IA a I I I 
GTEXTCONTROLSET (graf,option,color,size,font) 
ifo in in in in 
IA I I I I 
GTEXTCONTROLING (graf,option,color,size,font) 
i/o in out out out 
PARAMETERS 
graf Integer array containing global information used by 
DSG/3000. The first word returns the call status. 
option Integer code indicating which text entity will be 


affected. Code as follows: 


Title 

Subtitle 

Footnote 

Horizontal axis title (bar and line charts only) 
Vertical axis title (bar and line charts only) 
Right axis title (bar and line charts only) 
Second footnote (pie charts only) 

X-axis labels (bar and line charts only) 
Y-axis labels (bar and line charts only) 

10 Pie segment labels (pie charts only) 

11 Legend text (bar and line charts only) 


OO ON NU LW ND F 
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Parameters (continued) 


color 


size 


Integer code corresponding to the color assigned 
to the text entity: 


color of pen 
color of pen 
color of pen 
color of pen 


rWN Fe 
rWN EF 


16 color of pen 16 
0 = default; maximum value = 16 


If the device has less than 16 colors, the numbers 
will wrap around through the colors available. On 
a 4-pen plotter, for example, colors 1,5,9, and 13 
will all use pen 1. 


This parameter is ignored if the plotting device 
is a non-color device. 


(0-72) Integer code corresponding to the size of 
the characters. The smallest is 1; 72 is the 
maximum value. The default (0) size depends on the 
text option. 
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Parameters (continued) 


The default sizes are: 


Bar and Line Charts Pie Charts 
Main Title 8 Main Title 8 
Subtitle 6 Subtitle 6 
Left Axis Title 5 Segment Labels 4 
Bottom Axis Title 5 

X-Axis Labels 4 

Y-axis Labels 4 

Legend Text 5 


font (0-4) Integer code corresponding to the font 
previously defined through GFONTSET. The default 
font (0) is font 1 (Stick font). 


See GFONTSET. 
DISCUSSION 


The size of the text is relative to the entire chart size. For small charts, 
you may want the text size to be relatively large to insure that it is readable. 
Note that increasing the size of any text may cause character truncation, 
depending on the length and position of the string on the chart, or it may 
result in overlaying other portions of the chart. 
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SET 
GTITLE 


Sets or returns title, subtitle, footnote, and axes titles. Callable from all 
languages. 


FORMAT 
IA E BA I Hs I 
GTITLESET (graf,option,titlebuf,titlelen,size,font, 
i/o in in in in in 
I 
useroptions) 
in 
TA Z BA I I I 
GTITLEINQ (graf,option,titlebuf,titlebuflen,titlelen,size, 
i/o in out in out out 
I I 
font,useroptions) 
out out 
PARAMETERS 
graf Integer array containing global information used by 
DSG/3000. The first word returns the call status. 
option Integer code indicating which title is being set: 
1 title 
2 subtitle 
3 footnote 
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Parameters (continued) 


titlebuf 


titlelen 


size 


font 


useroptions 


titlebuflen 


4 X-axis (horizontal) title (bar and line graphs 
only) 

5 Y-axis (vertical) title (bar and line graphs 
only) 

6 right axis title (bar and line graphs only) 

7 second footnote (pie charts only) 


Byte array holding the title. The maximum lengths 
allowed are as follows: 


title 45 characters 
subtitle, same size as title 45 characters 
subtitle, smaller than title 64 characters 
all others 90 characters 


Integer variable specifying length in bytes of 
title. 


Integer code specifying the relative character 
size of the subtitle: 


0 small = text size 6 (default) 
1 big = text size 8 


This parameter is ignored unless a subtitle is 
being set. 


Integer variable specifying pre-established type 
font. A maximum of four fonts may be active for 
any chart. Enter 1-4. Default=1 (usually STICK font). 


Integer variable ignored by procedure. User 
comment area. 


Integer variable specifying length in bytes of the 
title buffer. 


7-118 


DISCUSSION 


Any graph can be given a title, subtitle (smaller type), and footnote. In 
addition, bar and line graphs can have their axes titled. Pie charts are 
allowed a second line for footnotes. 


The main title, subtitle, footnote, and X-axis title are centered when printed 
on the graph. The Y-axis title is left-justified. Leading and trailing blanks 
are stripped when the graph is printed although they are retained when GTITLEINQ 
returns them. 


Call GTITLESET once for each title. 


Four type fonts may be active for a single chart. They are established through 
GFONTSET, which allows you to map the fonts you have selected to a font number. 


Note that if the size of titles is changed using GTEXTCONTROLSET, character 
truncation or title overlay may occur. 


Special Character Strings 


A title can contain any of the following special strings: 


$TODAY Represents the current date in the form mm/dd/yy 
with the leading zeros suppressed. For example, 
9/16/82. 

$MONTH Represents the current month spelled out in full. 


For example, SEPTEMBER. 
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$M 


$DAY 


$YEAR 


$y 


Represents the current month numerically. For 
example, 9. 


Represents the current numeric day of the month. 
For example, 16. 


Represents the current year in 4 digits. For 
example, 1982. 


Represents the current year by its last two digits. 
For example, 82. 
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ET 
GTRAN 


Sets or returns variable transformations as a group for the current chart. 
Callable from all languages. 


FORMAT 


IA I BA BA I 
GTRANSET (graf ,numtrans,varbuf,exprbuf,exprlen) 
i/o in in in in 


IA I I I BA I 
GTRANING (graf,firstrans ,maxtrans ,numtrans,varbuf,varbuflen, 
i/o in in out out in 


BA be I 
exprbuf ,exprbuflen,exprlen) 
out in out 


PARAMETERS 


graf Integer array containing global information used by 
DSG/3000. The first word returns the call status. 


numtrans Integer variable specifying the number of 
transformations. This is also the number of 
variable names in varbuf and the number of 
expressions in exprbuf. The maximum is 10. 


varbuf 16-byte array holding the names of the variables being 
created. 
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Parameters (continued) 


exprbuf 


exprien 


firstrans 


maxtrans 


varbuflen 


exprbuflen 


DISCUSSION 


See page 3-18. 


Note: The special functions, CUMULATE (Cumulation) and MOVEAVG (Moving Average) 


may not be nested. Also, total muwntrans is available from GDATAINFO. 


Byte array holding the transformation expressions. 
All transformation expressions are of the same 
length, padded with blanks if necessary, and can 
use any operators given in Table 3-3. 


Integer variable specifying the length in bytes of 
a single transformation expression. 


Integer variable specifying the relative number of 
the first transformation you want returned. The 
first transformation specified in the expression 
buffer is numbered one. 


Integer variable specifying the maximum number of 
transformations you want returned. 


Integer variable specifying the length in bytes of 
the variable buffer. A warning is returned if the 
buffer is too small to receive the variable names. 


Integer variable specifying the length in bytes of 
the expression buffer. A warning is returned if 
the buffer is too small to receive the 
transformations. 
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COLORS, TEXTURES, 
MARKERS AND FONTS 


Colors 


HP makes a variety of pen colors and pen 
widths available to its users as well as 
transparency colors in two widths and 
spectrum colors for paper. This pre- 
sents you with a variety of choices and 
a chance to experiment with the effects 
best suited to your charting needs. 


There are 1- ,2- ,4- ,8- and 16-pen 
holders. The maximum number of colors 
for your graph equals the number of 
pens in your holder. The colors are 
stored in a circular buffer. 


If your holder has fewer than 8 pens, 
the colors will be repeated in the order 
they have been loaded into the holder. 
For example, if you have loaded black, 
green, red, and blue in holders one 
through four respectively, the fifth 
color will be black, the sixth red, the 
seventh green, and the eighth blue. 

This repetition will continue for all 
colors called for in your chart. 


Generally, black is the color chosen for 
pen holder 1, because the pen in this 
position is used to frame your charts, 
draw axes, and write labels. Red is 
often used for elements in the chart you 
wish to emphasize. Below is the stand- 
ard location for the first four pen pos- 
itions. 


Location Standard Color 
Pen 1 Black 

Pen 2 Red 

Pen 3 Green 

Pen 4 Blue 


Line Textures 


The line textures were developed to vis- 
ually create a logical transition be- 
tween two basic line types, continuous 
and dotted. These line textures provide 
enough contrast between them so that 
there is an obvious difference, but not 


Order of Use 





so much that they compete with each 
other as primary focal points for the 
graph. 


The following describes the line texture 
types, their dimensions and order of 
use. 


One Line 

TWO Lines  mmmmsmmmmemumnnn soc cssccceces 

Three Lines ee ait ee ee Coe reecccecccce 

Four Lines Me las armtitias a ere soccer eccecccce 

Five Lines Lo 2 Dee Sd cee Sepia anaes 

Seine aE a he ee eee et ee Doe ceneeeneees 

Seven Lines Ee ee” eee en ene eee eae ee ant ear ens rrr rrr rrr 
1 5 6 7 





Eight Lines 


Line Textures 





O None 3 So Re ee 
1 6 aaanenemeemen ne wmam 
De ie ee YS a ee ee Ee OTS 
oe ae eee ee eee ee D asdadiee seeks eeenw Coteniees 
4 


re ee ree ee ee ee ee ere ee 


— ee ee ew ESS SS eK KH MMW Mange eee ee eeeeeeosed 


Data Point Markers 


O = none 5=0 
1=* 6 = 

2+ 7=@ 
aoe 8=x 








Available Textures 


texture 7 


texture 8 


texture 1 


texture 5 


texture 2 





texture 4 


texture 3 





Surface Textures--Order of Use 





One Label 


LLLLLLS 


Five Labels 








SURFACE TEXTURE TYPES 
AND ORDER OF USE 


Two Labels Three Labels Four Labels 


0.0.0 028 eeu. 
mesensnccae 
SSSI 
oteteter eter etetetets 
reasstosetonstesseeseseaeees 


Six Labels 


YUL), 


LLM 


SS Bae 


e 
CAPR AOATS. 








Text Sizes 


The text size examples shown below are 
software sizes. These sizes conform to 
point size measurements when you are us- 
ing a standard (8 1/2 by 11 inches) 
sheet of paper. When the paper is a 
different size, these sizes will expand 
or reduce accordingly. 


Hardware sizes will adjust in the “best 
fit" mode. When hardware sizes do not 


match the software size exactly, the 
hardward size closest to a perfect match 
will be selected automatically. 
Quick-drawing hardware sizes may be used 
effectively when you are designing the 
chart and wish to draw your chart on the 
screen to make sure the elements are 
balanced and command the visual at- 
tention they should. You can then use 
the slow-drawing but more refined soft- 
ware text for plotting the finished 
chart. 


POINT SIZE EXAMPLE (6—72) 


6 POINT 
8 POINT 


70. POINT 
TZ POUT 


> ONG 


20 POINT 


25 POINT 
OW) PUNT 


53D POINT 
40 POINT 


590 POINT 
OO POINT 


JZ POINT 


Text Fonts 


Below are examples of the text fonts 
presently available for use. These are 
software fonts. Only one hardware font, 
Stick, is now available. 


Giri io. ote 
tals 1S Suck 


JIC: Oo woos 
THIS IS ROMAN 
this 1s roman 


THIS IS GOTHIC 
this is guthic 
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Native Language Characters 


DSG/3000 allows users to specify native 
language characteristics for seven 
languages for both hardware and soft- 
ware fonts. Examples of the characters 
for each language are shown below. 


1. USASCII (Language=1) — Software 


ABCDEF GHIUKLMNOPQRSTUVWXYZ 
abcdefghijkimnopqrstuvwxyz 


#@I\I [i IPRSceCV_ — + =1;'"? /<>,. 


2.Swedish (Language=2) — Software 


ABCDEF GHIJKLMNOPQRSTUVWXYZ 


abcdefghijkimnopaqrstuvwxyz 


#HEAOAUEGS4t 


I$%acx()_ —+=33'? /<>,,. 


USASCII (Language=1) - Hardware 


ABCDEFGHIJKLMNOPQRSTUVWXYZ 
abcdefghijklimnoparstuvwxyz 


#6 [\]** {l}~ |! $%&% () -t=::"'?/<>, . 


Swedish (Language=2) - Hardware 


ABCDEF GHIJKLMNOPGRSTUVWXYZ 


abcdefghijklmnopqrstuvwxyz 


EAOAUéa0au =! $K&X ()_-t=:; "°?/<>, - 


3. Danish (Language=3) — Software 


ABCDEFGHIJKLMNOPQRSTUVWXYZ 


abcdefghijklimnopaqrstuvwxyz 


H@EOA~*eowd~ = !$%acx()_—+=1;'"?/<>,. 


4. French (Language=4) — Software 
ABCDEFGHIJUKLMNOPQRSTUVWXYZ 
abcdefghijklmnopqrstuvwxyz 


£a° SSS” 1'GMRc#()_-— +H 3;'"? /<>,. 


5. German (Language=5) — Software 


ABCDEFGHIJKLMNOPQRSTUVWXYZ 
abcdefghijkimnopaqrstuvwxyz 


ESAOU~*GOUB  1H%&c#()_—+=3;'"2/<>,. 
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Danish (Language=3) - Hardware 


ARCUEFGHTIO*KL MNGEGRASTUVWRY 2 
abcde fghijklmnopaqrstuvwxyz 


PEGA ‘woa | $%¥8%() -t=: "'?/<>,. 


French (Language=4) -— Hardware 
ABCDEF GHIJKLMNOPGRSTUVWXY Z 
abcdefghijklmnopaqrstuvwxyz 


fac **é0e" !$%&% () _-+=:;."°°?/<>, . 


German (Language=5) - Hardware 


ABCDEFGHIJKLMNOPGRS TUVWXYZ 
abcdefghijklmnopaqrstuvwxyz 


£@A00* *aouB ! $¥&x () _-t+=:; "°?/<>,. 


6. United Kingdom (Language=6) — 


Software 


ABCDEFGHIJKLMNOPQRSTUVWXYZ 
abcdefghijklmnopaqrstuvwxyz 


LOI“ 1 $%Scx()_—+=3;'7?/<>,, 


- Spanish (Language=7) — Software 


ABCDEFGHIUKLMNOPQRSTUVWXYZ 
abcdefghijkimnopaqrstuvwxyz 


#@INC* Aw 1$%8cx()_—t=3'"2/<>,, 


(Language=6) - 
Hardware 


United Kingdom 


ABCDEF GHIJKLMNOPGRSTUVWXYZ 
abcdefghijkimnopaqrstuvwxyz 


£@ [/] ** [! ] 1 $%¥GX ()_-t=:35 ""P/<>, , 


Spanish (Language=7) - Hardware 


ABCDEFGHIJKLMNOPGRSTUVWXYZ 
abcdefghijklmnopaqrstuvwxyz 


@iNe “(A]l~ 1! $%8% ()_-t=:: "%?/e>, . 


PROGRAMMATIC 
EXAMPLES 


ome stn dl 


The following sample programs in COBOL, 
FORTRAN, SPL, PASCAL, and BASIC assume 
that you have created the chart file CF1 
and the pie chart FIRSTCHART as des- 
cribed in Section IV of this manual. 
This chart describes budget allocations 
among six departments of a company. 
There are six segments, and each is 
labeled with the department name and the 
percent of budget which that department 
receives. The segment describing the 
Research and Development department is 
exploded. The chart also has a two-line 
title and a two-line footnote. 


The sample programs will add six dif- 
ferent textures to the segments, four 
different colors, and will produce the 
chart on a 9872A 4-pen plotter. If you 
have a different plotter, you will have 
to substitute appropriate values for 
that device in the call to GDEVICESET. 


The SPL, FORTRAN, PASCAL and COBOL 
programs must be :PREPed with a MAXDATA 
value of 32000. Required capabilities 
are: 


CAP=PH,MR,DS 


REMX% % & % % KK KIO III IO III III IO III IOI IO 


REM* x 

REM* BASIC SAMPLE PROGRAM 4 
x 

AF Asa cee uabead eee Or eia Liha eon ee ee eee 

REM : 

REM DECLARATIONS x 

REM * 


REMX% % KR IK KI III I IOI III IO III III II IOI III IOI ICICI 


Ae aes For GINITGRAF: G is GRAF, S is GRAFSIZE, L is LANGUAGE 
M 
aur oee G[3700],S,L 


M 
ai For GOPENFILE: F$ is FILENAME, Al is ACCESS 
DIM F$[36] 
INTEGER Al 
REM 
ie For GGETCHART: C$ is CHARTNAME 
ne C$[16] 
REM*** For GPIESET: Pl is PERCENT, A2 is ACTUAL, C[4] is COLORBUF, 
si Cl is COLORBUFLEN, T[6] is TEXTUREBUF, T1 is TEXTUREBUFLEN 
aN VESES P1,A2,C[4],C1,T{6],T1 
REM*** For GDEVICESET: D$ is DEVICE, H is HPIB, C2 is COPIES, 
pee P2 is PENSPEED, C3 is CHARQUAL 
DIM D$[6] 
Neoee H ,C2,P2,C3 
sae For GEXECHART: O is OPTIMIZE 
eee ‘¢) 
oe For GERRORMSG: M$ is MSGBUF, Ml is MSGBUFLEN, M2 is MSGLEN 
DIM M$[72] 
INTEGER Mi ,M2 
REM 
REM*** P$ is for error routine 
REM 
DIM P$[{16] 
REM 


RE MX¥ & HII HI I I KI RII III III IOI IOI IR II IOI III III IOI IOI II IOI I I III 


REM 2 
REM MAIN PROGRAM x 
REM x 


RE MX & KOK III III III III III KOK 


REM 


Pee bee bee ee fe ee Bt ee pet at bat fet at pate bt fet fe be bt bt be be pe be be ee be 
WWWWWWWWWWNNNNNNNNND RRR REE RRR rE 
CONDUPWONKHKOWDOANDMNRPUWUNRPOOONOMAWNRO 
DODDDDDVODDOODOCOCOOCOCOCOOCCOOCO000000090 


P2=0 

C3=1 

CALL GDEVICESET(G[*] ,D$,H,C2,P2 

IF G[1]<>0 THEN DO 
P$="GDEVICESET" 
GOSUB 1380 

DOEND 

REM 

oe ails Prepare data for gr 
M 

CALL GEXECDATA(G[*]) 

IF G[1]<>O THEN DO 
P$="GEXECDATA" 
GOSUB 1380 

DOEND 


M 
REM* #2 ®x Draw chart, optimiz 


GOSUB 1380 
DOEND 
REM 
ee Terminate access to 
CALL GTERMGRAF (G[*]) 
IF G[1]<>0 THEN DO 
P$="GTERMGRAF ™ 
GOSUB 1380 
DOEND 
END 


REMX & & XK KKK KR KK KKK KK KKK KK 


REM* 


REM ERROR ROUTINE 
SE MRNA RUNS wei R uae am KaOEN 


REM 

PRINT “Error returned by call to 
M1=72 

CALL GERRORMSG(G[*] ,M$,M1,M2)} 
PRINT M$ 

CALL GTERMGRAF (G[*] } 

END 


,C3) 


aphing 


ing when possible 


DSG/3000; 


KR KKK KOK KOK KK KOK KK KKK KKK 
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"PS 
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closes chart file 


Ree Initialize GRAF array; MUST be first call 
$=3700 
L=1 
CALL Fe ee ee S,L) 
IF G{1]<>0O THEN 
P$= *dINITGRAF“ 
GOSUB 1380 
REM 
DOEND 
Bete Open existing chart file CFl in exclusive mode 
F$="CF1 " 
Al=1 
CALL Foie e ithe Oe F$ Al) 
IF G{1]<>0O THEN 
pSi"GOPENFILE™. 
GOSUB 1380 
DOEND 
REM 
REMX * * x * Retrieve chart FIRSTCHART 


REM 
C$="FIRSTCHART : 
CALL ae ats a C$) 
IF G{1]<>0O THEN 
P$= "dGETCHART". 
GOSUB 1380 
DOEND 
REM 
REM****% Specify 4 colors and 6 textures for pie segments 
See Label percentages, but not actual values 
Pi=1 
A2=0 
DATA 1,2,3,4 
MAT READ C 
C1=4 
DATA 1,2,3,4,5,6 
MAT READ T 
T1=6 
CALL GPIESET(G[*],P1,A2,C[*],C1,T[*],T1) 
IF G[{1]<>0 THEN DO 
P$="GPIESET"” 
GOSUB 1380 
DOEND 
REM 
REM* * * xx Draw 1 copy of the chart on a 9872A plotter 
ts ae at fast pen speed using hardware characters 
D$="9872A " 
H=5 
C2=1 
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«< >> 
K< >> 
<< SPL SAMPLE PROGRAM >> 
<< >> 
<< >> 
K< Global Declarations >> 
<< >> 


LK KK KK I KIKI III OI III III I KK IK > > 


BEGIN 
INTEGER ARRAY GRAF(O:1599); 
DEFINE 
STATUS = GRAF (0) #, << Status word >> 
PARAM = GRAF (1) #, << Parameter in error, if any >> 
ELEMENT = GRAF (2) #, << Element of the parameter in error >> 
F SERROR = GRAF (3) #; << File system error number, if any >> 
<<*** GINITGRAF parameters ***>> 
INTEGER GRAF ’SIZE, 
LANGUAGE ; 
<<x** GOPENFILE parameters ***>> 
BYTE ARRAY FILE’ NAME(0:35):=36(" "); 
INTEGER ACCESS; 
<<x**k GGETCHART parameters ***>> 
BYTE ARRAY CHART’ NAME(0:15):=16(" "J; 
<<**xx GPIESET parameters ***>> 
INTEGER PERCENT, 
ACTUAL, 


COLOR ' BUF’ LEN, 

TEXTURE ' BUF’ LEN; 
INTEGER ARRAY COLOR ' BUF (0:3), 

TEXTURE ’ BUF (0:3); 


<<*x* GDEVICESET parameters ***>> 


BYTE ARRAY DEVICE(0:5); 
INTEGER HPIB, 
COPIES, 
PEN’ SPEED, 
CHAR ’ QUAL; 
<<*x** GEXECHART parameters ***>> 
INTEGER OPTIMIZE ; 
<<**k* GERRORMSG parameters ***>> 
BYTE ARRAY MSG’ BUF (0:71); 
INTEGER LENGTH, 
RETURN’ LEN; 
BYTE ARRAY PROCEDURE 'NAME(0:15):=16(" "); 


LOGICAL ARRAY L’MSG’ BUF (*)=MSG’ BUF (0); 
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<< DSG/3000 PROCEDURES >> 


KC RRR KR KR RRR KR IK RK OOO OI OOO KIO IOI IK IK > > 


<< 

INTRINSIC 
GINITGRAF , 
GOPENFILE, 
GGETCHART, 
GEXECDATA, 
GEXECHART, 
GTERMGRAF , 
GERRORMSG, 
GDEVICESET, 
GPIESET; 


>> 
INTRINSIC PRINT; 


PROCEDURE GINITGRAF (GRAF ,GRAF’ SIZE, LANGUAGE); 
INTEGER ARRAY GRAF ; 
INTEGER GRAF ’SIZE, LANGUAGE ; 
OPTION EXTERNAL; 
PROCEDURE GOPENFILE(GRAF ,FILE’ NAME , ACCESS) ; 
INTEGER ARRAY GRAF ; 
BYTE ARRAY FILENAME; 
INTEGER ACCESS; 
OPTION EXTERNAL: 
PROCEDURE GGE TCHART (GRAF , CHART ’ NAME ) ; 
INTEGER ARRAY GRAF 
BYTE ARRAY CHART’ NAME; 
OPTION EXTERNAL ; 
PROCEDURE GEXECDATA(GRAF ); 
INTEGER ARRAY GRAF ; 
OPTION EXTERNAL; 
PROCEDURE GEXECHART (GRAF ,OPTIMIZE) ; 
INTEGER ARRAY GRAF ; 
INTEGER OPTIMIZE; 
OPTION EXTERNAL; 
PROCEDURE GTERMGRAF {GRAF } ; 
INTEGER ARRAY GRAF ; 
OPTION EXTERNAL ; 
PROCEDURE GERRORMSG (GRAF ,MSG’ BUF , LENGTH, RETURN’ LEN); 
INTEGER ARRAY GRAF - 
BYTE ARRAY MSG’ BUF ; 
INTEGER LENGTH, RETURN’LEN: 
OPTION EXTERNAL: 
PROCEDURE GDEVICESET(GRAF ,DEVICE ,HPIB ,COPTIES, PEN’ SPEED, CHAR ’ QUAL ) ; 
INTEGER ARRAY GRAF ; 
BYTE ARRAY DEVICE; 
INTEGER HPIB, COPIES, PEN’SPEED, CHAR’ QUAL; 
OPTION EXTERNAL; 
PROCEDURE GPIESET(GRAF , PERCENT , ACTUAL , COLOR ’ BUF , COLOR’ BUF ’LEN, 
TEXTURE BUF , TEXTURE BUF LEN 
INTEGER ARRAY GRAF, COLOR’BUF, TEXTURE’ BUF ; 
INTEGER PERCENT, ACTUAL, COLOR’ BUF ’LEN, TEXTURE’ BUF ’LEN; 
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OPTION EXTERNAL; 
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«< »> 
<< ERROR ROUTINE »> 
«< >> 


LIKI II II IOI IOI OKI III IK KOI KR AR KR KK KKK KKK KKK KD D> 


PROCEDURE ERROR (PROCEDURE ’ NAME); 

BYTE ARRAY PROCEDURE ’ NAME ; 

BEGIN 
MOVE MSG’BUF:="Error returned by call to "; 
MOVE MSG’ BUF(26):=PROCEDURE’NAME, (16); 
PRINT (L’MSG’ BUF ,-42 ,%40) ; 
LENGTH: =72; 
GERRORMSG (GRAF, MSG’BUF, LENGTH, RETURN’LEN); 
PRINT (L’MSG’ BUF ,-RETURN’LEN,O); 

END ; 


LC KK RR KI KR KR KIO FO II IOI III ROI IO IK IOI RIK IIE > 


«<< >> 
«< MAIN PROGRAM >> 
«< >> 


CORR RRR KK IK RK KI KKK IK KIRK RR RK KIKI KK KOR KKK KR KKK KK KD > 


<< Initialize GRAF array; MUST be first call >> 


GRAF ’SIZE:=1600; 
LANGUAGE : =3; 
GINITGRAF (GRAF, GRAF’SIZE, LANGUAGE); 
IF STATUS <> O THEN 
BEGIN 
MOVE PROCEDURE ’ NAME :="GINITGRAF"; 
ERROR (PROCEDURE ’ NAME}; 
ND” TERMINATE ; 


<< Open existing chart file CF1l in exclusive mode >> 


MOVE FILE’NAME:="CF1 "; 
ACCESS: =1; 
GOPENFILE (GRAF, FILE’NAME, ACCESS); 
IF STATUS <> O THEN 
BEGIN 
MOVE PROCEDURE’ NAME: ="GOPENFILE”; 
ERROR (PROCEDURE ’ NAME}; 
ine TERMINATE; 


<< Retrieve chart FIRSTCHART >> 
MOVE CHART’ NAME: ="FIRSTCHART"; 


GGETCHART (GRAF, CHART’ NAME}; 
IF STATUS <> O THEN 
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BEGIN 
MOVE PROCEDURE ’ NAME : ="GGETCHART"; 
ERROR (PROCEDURE ’ NAME) ; 
GO TERMINATE ; 


END; 
<< Specify 4 colors and 6 textures for pie segments >> 
<< Label percentages, but not actual values >> 
PERCENT: =1; 
ACTUAL: =0; 


MOVE COLOR’ BUF :=(1,2,3,4); 
COLOR’ BUF’ LEN: =4; 
MOVE TEXTURE’ BUF :=(1,2,3,4,5,6); 
TEXTURE ’BUF LEN: =6; 
GPIESET (GRAF, PERCENT, ACTUAL, COLOR’BUF, COLOR’ BUF 'LEN, 
TEXTURE’ BUF, TEXTURE’ BUF ’LEN); 
IF STATUS <> O THEN 
BEGIN 


MOVE PROCEDURE ’NAME : ="GPIESET":; 
ERROR (PROCEDURE ’ NAME) ; 
GO TERMINATE ; 


END ; 
<< Draw 1 copy of the chart on a 9872A plotter at fast pen >> 
<< speed using hardware characters >> 
MOVE DEVICE:="9872A "; 
HPIB:=5; 
COPIES: =1; 


PEN’ SPEED: =0; 
CHAR ’ QUAL: =1; 
GDEVICESET (GRAF, DEVICE, HPIB, COPIES, PEN’SPEED, CHAR’QUAL); 
IF STATUS <> O THEN 
BEGIN 
MOVE PROCEDURE ’NAME :="GDEVICESET"; 
ERROR (PROCEDURE ’ NAME } ; 
a ce TERMINATE ; 


<< Prepare data for graphing >> 


GEXECDATA (GRAF) ; 
IF STATUS <> 0 THEN 
BEGIN : 
MOVE PROCEDURE ’ NAME :="GEXECDATA" ; 
ERROR (PROCEDURE ’ NAME J ; 
ENDS TERMINATE ; 


<< Draw chart, optimizing when possible >> 


OPTIMIZE: =1;: 


225 
226 
227 
228 
229 
230 
231 
232 
233 
234 
239 
236 
237 
238 
239 
240 
241 
242 
243 
244 
245 


GEXECHART (GRAF, OPTIMIZE); 
IF STATUS <> O THEN 
BEGIN 
MOVE PROCEDURE ’NAME : ="GEXECHART" ; 
ERROR (PROCEDURE ’ NAME ) ; 
GO TERMINATE ; 
END ; 


<< Terminate access to DSG/3000; closes chart file »>> 
TERMINATE: 


GTERMGRAF (GRAF }; 
IF STATUS <> O THEN 
BEGIN 
MOVE PROCEDURE ‘NAME : ="GTERMGRAF " ; 
Sener { PROCEDURE ’ NAME) ; 


END. 
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FORTRAN SAMPLE PROGRAM 


x 
* 
x 
Global Declarations : 
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90 AQ ANAAANNANAAS 


INTEGER GRAF (1600) 


.GINITGRAF parameters 


INTEGER GRAFSIZE, LANGUAGE 


.GOPENFILE parameters 


CHARACTER*36 FILENAME 
INTEGER ACCESS 


.GGETCHART parameters 


CHARACTER*16 CHARTNAME 


.GPIESET parameters 


INTEGER PERCENT, ACTUAL, COLORBUF 


(4), COLORBUFLEN 
INTEGER TEXTUREBUF(6), TEXTUREBUFL 


4) 
EN 


.GDEVICESET parameters 


CHARACTER*6 DEVICE 
INTEGER HPIB, COPIES, PENSPEED, CHARQUAL 


.GEXECHART parameters 


INTEGER OPTIMIZE 


.GERRORMSG parameters 


CHARACTER*72 MSGBUF 
INTEGER LENGTH, RETURNLEN 


CHARACTER*16 PROCNAME 


...Equivalence status word to GRAF array 


EQUIVALENCE (STATUS, GRAF (1) ) 


SYSTEM INTRINSIC GINITGRAF ,GOPENFILE ,GGETCHART , GEXECHART 
SYSTEM INTRINSIC GEXECDATA,GERRORMSG ,GPIESET , GTERMGRAF 


SYSTEM INTRINSIC GDEVICESET 


KKK K KKK KK RK KKK KKK KKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK 


MAIN PROGRAM 


KKK KK KK KKK KKK KKK KKK RK RK RRR KK KR KK RK KO KK ko kk KK KK kkk kk 


...Initialize GRAF array; MUST be first call 


GRAFSIZE=1600 
LANGUAGE =2 
CALL GINITGRAF (GRAF, GRAFSIZE, LANGUAGE ) 
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PROCNAME = "GINITGRAF” 
IF (STATUS .NE. 0) GOTO 900 


.Open existing chart file CF1l in exclusive mode 


FILENAME="CF1 " 

ACCESS=1 

CALL GOPENFILE Spe FILENAME, ACCESS) 
PROCNAME = "GOPENFILE" 

IF (STATUS .NE. 3) *GOTO 900 


Retrieve chart FIRSTCHART 
CHARTNAME="FIRSTCHART " 
CALL GGETCHART (GRAF, CHARTNAME ) 
PROCNAME = “GGETCHART" 
IF (STATUS .NE. 0) GOTO 900 


.Specify 4 colors and 6 textures for pie segments 


_. Label percentages, but not actual values 


PERCENT=1 
ACTUAL=0 


....set up COLORBUF 


DO 10 T=1,4 
COLORBUF (I)=I 
10 CONTINUE 
COLORBUF LEN=4 


_...Set up TEXTUREBUF 


DO 20 I=1,6 
TEXTUREBUF (I)=I 
20 CONT INUE 
TEXTUREBUFLEN=6 
CALL GPIESET (GRAF, PERCENT, ACTUAL, COLORBUF , 
& COLORBUFLEN, TEXTUREBUF, TEXTUREBUFLEN) 
PROCNAME = “GPIESET" 
IF (STATUS .NE. GO) GOTO 900 


.Draw 1 copy of the chart on a 9872A plotter at 
.fast pen speed using hardware characters 


DEVICE="9872A “ 

HPIB=5 

COPIES=1 

PENSPEED=0 

CHARQUAL=1 

CALL GDEVICESET (GRAF, DEVICE, HPIB, COPIES, PENSPEED, 
& CHARQUAL } 

PROCNAME = "GDEVICESET" 

IF (STATUS .NE. 0) GOTO 900 


-Prepare data for graphing 
CALL GEXECDATA (GRAF }) 


PROCNAME = "“GEXECDATA" 
IF (STATUS .NE. 0) GOTO 300 


Beit 
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C...Draw chart, optimizing when possible 


Cc 

OPTIMIZE=1 

CALL GEXECHART (GRAF, OPTIMIZE) 

PROCNAME = "GEXECHART" 
‘ IF (STATUS .NE. 0) GOTO 900 
pore terminate access to DSG/3000; closes chart file 

CALL GTERMGRAF (GRAF) 

PROCNAME = "GTERMGRAF “ 
3 IF (STATUS .NE. 0) GOTO 900 
Cc 

STOP 
cei pacna wae ed SENNA ee Een ene a ea eaNS 
cx * 
cx ERROR ROUTINE x 
cx x 


CK RK RK KR KK KKK RK KK KKK KKK KK KKK KKK KK KKK KK KKK KKK KKK KKK KK KKK KKK KKK 


Cc 
900 DISPLAY “Error returned by call to ", PROCNAME 
LENGTH=72 
MSGBUF="_ " 
CALL GERRORMSG (GRAF, MSGBUF, LENGTH, RETURNLEN) 
DISPLAY MSGBUF 
CALL GTERMGRAF (GRAF ) 
STOP 
END 
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$CONTROL USLINIT 
IDENTIFICATION DIVISION. 
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* 
* 
* 
‘ COBOL SAMPLE PROGRAM 
* 
x 


* 
* 
* 
* 
* 
ROKK IKK KI III III KK KI OI III I III III IK Ik 


PROGRAM-ID. COBOL-SAMPLE . 
DATE-COMPILED. 


ENVIRONMENT DIVISION. 
CONFIGURATION SECTION. 
SOURCE-COMPUTER. HP3000. 
OBJECT-COMPUTER. HP3000. 


DATA DIVISION. 
WORKING-STORAGE SECTION. 


77° GPROCEDURE PIC X(i6) VALUE SPACES. 
OL GRAF. 
05 GSTATUS PIC S9(4) COMP. 
O05 PARAM PIC S9(4) COMP. 
O05 ELEMENT PIC S9(4)} COMP. 
05 FSERROR PIC S9(4) COMP. 
O05 FILLER PIC S$9(4) COMP OCCURS 1596 TIMES. 
O01 GINITGRAF-PARAMETERS. 
OS GRAF-SIZE PIC S9(4) COMP. 
05 LANGUAGE PIC $9(4) COMP. 
O01 GOPENFILE-PARAMETERS. 
OS FILE-NAME PIC X(36). 
05 ACCESS-MODE PIC $9(4) COMP. 
G1 GGETCHART-PARAMETERS. 
05 CHART-NAME PIC X(16). 
O1 GPIESET-PARAMETERS. 
O5 PERCENT PIC $9(4) COMP. 
05 GACTUAL PIC S9(4) COMP. 
O05 COLOR-BUF. 
10 COLOR-1 PIC $9(4) COMP. 
10 COLOR-2 PIC $9(4) COMP. 
10 COLOR-3 PIC $9(4) COMP. 
10 COLOR-4 PIC $9(4) COMP. 
05 COLOR-BUF-LEN PIC $9(4) COMP. 
O05 TEXTURE-BUF . 
10 TEXTURE-1 PIC $9(4) COMP. 
10 TEXTURE-2 PIC $9{4) COMP. 
10 TEXTURE-3 PIC $9(4) COMP. 
10 TEXTURE-4 PIC S$9(4) COMP. 
10 TEXTURE-5 PIC S9(4) COMP. 
10 TEXTURE-6 PIC $9(4)} COMP. 
OS TEXTURE-BUF-LEN PIC S$9(4) COMP. 
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O01 GDEVICESET-PARAMETERS. 
DEVICE PIC 


05 X(6} 

OS HPIB PIC S$9(4) COMP. 

0S COPIES PIC $9(4) COMP. 

O05 PEN-SPEED PIC S9(4) COMP. 

05 CHAR-QUAL PIC $9(4) COMP. 
O1 GEXECHART-PARAMETERS. 

05 OPTIMIZE PIC S$9(4) COMP. 
O1 GERRORMSG~-PARAMETERS. 

05 MSG-BUF PIC X(72) 

O05 GLENGTH PIC S9(4) COMP. 

O05 RETURN-LEN PIC $9(4) COMP. 


PROCEDURE DIVISION. 


KKK KR KKK KKK KKK KKK KK KIRK IKK KKK KKK KKK KKK KIRK KKK KKK KKK KK KKK KKK 


x x 
: MAIN PROGRAM f 
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MAINLINE. 
xxxkKK Tnitialize GRAF array; MUST be first call ***** 


MOVE 1600 TO GRAF-SIZE. 
MOVE O TO LANGUAGE. 
CALL "GINITGRAF" USING GRAF, GRAF-SIZE, LANGUAGE . 
IF GSTATUS IS NOT EQUAL TO 0 
MOVE "GINITGRAF" TO GPROCEDURE 
PERFORM ERROR-ROUTINE. 


akkxk*kk Open existing chart file CF1l in exclusive mode ***** 


MOVE "CFi " TO FILE-NAME. 
MOVE 1 TO ACCESS-MODE . 
CALL "“GOPENFILE" USING GRAF, FILE-NAME, ACCESS-MODE. 
IF GSTATUS IS NOT EQUAL TO 0 
MOVE "“GOPENFILE" TO GPROCEDURE 
PERFORM ERROR-ROUTINE . 


xxx Retrieve chart FIRSTCHART **x*** 


MOVE "FIRSTCHART" TO CHART -NAME . 
CALL “GGETCHART" USING GRAF, CHART-NAME. 
IF GSTATUS IS NOT EQUAL TO O 
MOVE "GGETCHART" TO GPROCEDURE 
PERFORM ERROR-ROUTINE. 


xxxkxKKK Specify 4 colors and 6 textures for pie segments ***** 
xxxxxkx Label percentages, but not actual values ie htatabs 


MOVE 1 TO PERCENT. 
MOVE O TO GACTUAL. 
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xx Set up COLOR-BUF ** 

MOVE 1 TO COLOR-1. 

MOVE 2 TO COLOR-2. 

MOVE 3 TO COLOR-3. 

MOVE 4 TO COLOR-4. 

MOVE 4 TO COLOR-BUF-LEN. 
xx Set. up TEATURE-BUF ** 

MOVE T 


1 TO TEXTURE-1. 
MOVE 2 TO TEXTURE-2. 
MOVE 3 TO TEXTURE-3. 
MOVE 4 TO TEXTURE-4. 
MOVE 5 TO TEXTURE-5. 
MOVE 6 TO TEXTURE-6. 
MOVE 6 TO TEXTURE-BUF-LEN. 
CALL "“GPIESET" USING GRAF, PERCENT, GACTUAL, 


COLOR-BUF , COLOR-BUF-LEN, 
TEXTURE-BUF, TEXTURE-BUF-LEN. 
IF GSTATUS IS NOT EQUAL TO 0 
MOVE "GPIESET" TO GPROCEDURE 
PERFORM ERROR-ROUTINE. 


*xxxk*x*k Draw 1 copy of the chart on a ee 
RRAKKE OSTZA peotner at fast pen speed **xx* 
xxkeKKX using hardware characters eee ate 


MOVE "9872A" TO DEVICE. 
MOVE 5 TO HPIB. 
MOVE 1 TO COPIES. 
MOVE O TO PEN-SPEED. 
MOVE 1 TO CHAR-QUAL. 
CALL "GDEVICESET" USING GRAF, DEVICE, HPIB, COPIES, 
PEN-SPEED, CHAR-QUAL. 
IF GSTATUS IS NOT EQUAL TO 0 
MOVE "“GDEVICESET" TO GPROCEDURE 
PERFORM ERROR-ROUTINE . 


xXx Prepare data for graphing ***** 


CALL “GEXECDATA" USING aaa 

IF GSTATUS IS NOT EQUAL TO 
MOVE "GEXECDATA" TO GPROCEDURE 
PERFORM ERROR-ROUTINE . 


xxx*KKK Draw chart, optimizing when possible ***** 


MOVE 1 TO OPTIMIZE. 
CALL "“GEXECHART" USING GRAF, OPTIMIZE. 
IF GSTATUS IS NOT EQUAL TO 0 
MOVE "GEXECHART" TO GPROCEDURE 
PERFORM ERROR-ROUTINE . 


xkkKKK Terminate access to DSG/3000; closes chart file ***** 
CALL "“GTERMGRAF" USING GRAF. 
IF GSTATUS IS NOT EQUAL TO QO 


MOVE "“GTERMGRAF” TO GPROCEDURE 
PERFORM ERROR-ROUTINE. 
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STOP RUN. 
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x x 
: ERROR ROUTINE a 
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ERROR-ROUTINE . 
DISPLAY “Error returned by call to ", GPROCEDURE. 
MOVE 72 TO GLENGTH. 
MOVE SPACES TO MSG-BUF. 
CALL "GERRORMSG" USING GRAF, MSG-BUF, GLENGTH, 


RETURN-LEN. 
DISPLAY MSG-BUF . 


CALL “GTERMGRAF" USING GRAF . 
STOP RUN. 
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KKAK KKK KKK KKK KKK DASCAL SAMPLE 


$STANDARD_LEVEL ’HP3000’$ { use 
program testdsg (input, output); 
type 

int = -32768..32767; { 16 bit 


str = packed array [1..16] of 
graf_type = RECORD 


status int; 
parm int; 
element int; 
fserror int; 
raf > array 
ND ; 
var 
grafarea graf_type; 


{ GINITGRAF parameters } 


int; 
int; 


rafsize 
anguage 


{ GOPENFILE parameters } 


filename 
access 


{ GGETCHART parameters } 


packed array [1. 
int; 


chartname packed array [1.. 


{ GPIESET parameters } 


percent int; 

actual int; 

colorbuflen int; 
texturebuflen int; 
colorbuf array [1..4] 
texturebuf array [1..6] 


{ GDEVICESET parameters } 


device packed array (1. 
hpib int; 
copies int; 
penspeed int; 
charqual int; 


{ GEXECHART parameters } 
optimize int; 
{ GERRORMSG parameters } 


ms gbuf packed array [1.. 


PROGRAM REKKKKKKKKKKKK KKK 
HP3000 Pascal Standards } 


integer } 


char; 


[1..1596] of int; 


.36] of char; 


16] of char; 


of int; 
of int; 


.6] of char; 


72) of char; 
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length > int; 
returnlen : int; 


{ global vars } 


i : int; 
proc_name : str; 


{ graphics intrinsics } 


procedure GINITGRAF ; 
intrinsic; 

procedure GOPENFILE: 
intrinsic; 

procedure GGETCHART; 
intrinsic; 

procedure GE XECHART ; 
intrinsic 

procedure GEXECDATA; 
intrinsic; 

procedure GERRORMSG; 
intrinsic; 

procedure GPIESET, 
intrins 

procedure GTERMGRAF 
intrins 

procedure QDEVICESET; 
intrins 

procedure GEKECF IGURE 
intrins 

procedure GDELETEF IGURE ; 
intrinsic 

procedure GTEXTCONTROLSET; 
intrinsic; 

procedure GTEXTCONTROLINQ; 
intrinsic 

procedure GF ONTSET; 
intrins 

procedure GFONTING: 
intrins 

procedure TERMINATE; 
intrinsic; 


procedure paserror (name : str); 


begin 
length := 72; 


GERRORMSG (grafarea, msgbuf, length, returnien); 


writeln (’ERROR IN ’, name); 
writeln ( msgbuf); 


GTERMGRAF (grafarea); 
TERMINATE ; 


end; 
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begin { Main Program } 


{ 
‘ initialize GRAFAREA record 


rafsize := 1600; 
anguage := 5; 
proc _name := ‘GINITGRAF’ ; 


GINITGRAF (grafarea, grafsize, language); 
if grafarea.status <> 0 then 
paserror (proc_name) ; 


{ 
{ Open chart file TO6T250A in exclusive mode 


filename := 'TO6T250A’ ; 
access := 1; 
proc_name := ’GOPENFILE’ ; 


GOPENFILE (grafarea, filename, access); 
if grafarea.status <> O then 
paserror (proc_name) ; 


{ 

Retrieve chart FIRSTCHART 
chartname *FIRSTCHART’; 

proc _name "GGETCHART’ ; 
GGETCHART (grafarea, chartname}); 


if grafarea.status <> O then 
paserror (proc_name) ; 


{ 
{ Specify 4 colors and 6 textures for pie segments 
{ Label percentages, but not actual values 
percent := 1; 
actual := Q; 
{ Set up colorbuf } 
for i := 1 to 4 do 
colorbuf [i] := i; 
colorbuflen := 4; 


{ 
‘ Set up texturebuf 
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for i := 1 to 6 do 
texturebuf [i] := i; 
texturebuflen := 6; 


proc _name := ’GPIESET’; 


GPIESET (grafarea, percent, actual, colorbuf, 
colorbuflen, texturebuf, texturebuflen); 
if grafarea.status <> 0 then 
paserror (proc_name}); 


{ 
{ Draw 1 copy of the chart on a 2647a terminal at 
{ fast pen speed using hardware characters. 


} 

device := ’2647A’; 

hpib := 5; 

copies := 1; 

penspeed := Q; 

charqual := 1; 

proc_name := ’GDEVICESET’ ; 

GDEVICESET (grafarea, device, hpib, copies, penspeed, 
charqual}; 


if grafarea.status <> 0 then 
paserror (proc_name); 


{ 

Prepare data for graphing. 
proc _name := ‘'GEXECDATA’ ; 
GEXECDATA (grafarea) ; 


if grafarea.status <> 0 then 
paserror (proc_name) ; 


{ Draw chart, optimizing when possible. 
optimize := 1; 

proc_name := *GEXECHART’ ; 

GEXECHART (grafarea, optimize); 


if grafarea.status <> 0 then 
paserror {proc_name) ; 


{ 
{ Terminate access to DSG/3000 and close chart file. 
} 

proc_name := *GTERMGRAF’ ; 
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end. 


GTERMGRAF (grafarea); 
if grafarea.status <> O then 
paserror (proc_name); 


{ Main Program } 
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NOTE: THE ! IN THE FOLLOWING ERROR 
MESSAGES WILL APPEAR AS A NUMBER OR TERT- 
UAL VARIABLE IN THE ACTUAL MESSAGES. 
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(Warning messages follow the error 
messages and are indicated by negative 


numbers. ) 


GIN 


1. 
2. 
3. 


4, 
sta 


10 
11 


12 


Error Message 


ITGRAF 


Logon device could not be 
opened. (FSERR!) 


Could not find out information 
about logon device. (FSERR !) 


Request for primary terminal 
status failed (FSERR !) 


Could not read primary 
tus (FSERR !) 


Request for secondary terminal 
status failed. (FSERR !) 


Could not read secondary 
terminal status. (FSERR !) 


Terminal read failed. (FSERR !) 


Failed to determine what kind 
of terminal user has. 


Request for graphics terminal 
identifer failed. (FSERR !) 


Could not read graphics 
terminal identifier. (FSERR !) 


GRAF AREA must be at least ! 
words long when called from 
BASIC. 


Meaning 


The terminal could not be opened. 
The terminal did not respond. 

Could not write the primary status 
request to terminal. 

FREAD failed. Could possibly be a 
data overrun or timeout. 

Could not write the secondary status 
request to terminal. 

FREAD failed. Could possibly be a 


data overrun or timeout. 


FREAD failed. Could possibly be a 
data overrun or timeout. 


The terminal status did not identify 
a HP DSG/3000 supported terminal. 


Could not write the graphics ID 
request to the terminal. 


FREAD failed. 


The communications area is too 
small. 
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Action 





Refer to the file system error 
number for more information 

and possible action. 

Contact system manager and refer 
to MPE file system error number. 


Refer to MPE file system error 
number and contact system manager. 
Try again. If unsuccessful, sta 
refer to MPE'S error number and 
contact system manager. 


Refer to MPE file system error 
number and contact system manager. 


Try again. If unsuccessful, refer to 
MPE file system error number and 
contact system manager. 


Try again. If unsuccessful, refer to 
MPE file system error number and 
contact system manager. 


Refer to reference manual for list 
of supported terminals or contact 
system manager. 


Refer to MPE file system error 
number and contact system manager. 


Refer to MPE file system errr number 
and contact system manager. 


Expand the grafsize parameter. 


Error Message 


13 GRAF AREA too short. Must be 
at least ! words long. 


14 LANGUAGE must be an integer 
in range 0 to 3. 


15 Additional stack space not 
available. 


16 INTERNAL ERROR: illegal 
value passed to DLSIZE. 


17 Requested DLSIZE exceeded 
maximum limit allowed. 


18 INTERNAL ERROR: AGL GINIT 
failed. 


19 Could not close graphics 
device. (FSERR !) 

GCREATEFILE 

20 Chart file must be large 
enough to contain at least 


one chart. 


21 DOMAIN parameter must be 
either 0, 1, or 2. 





23 Could not create a new 
chart file (FSERR !) 


24 Could not get information 
about the new chart file. 
(FSERR !) 


25 Could not create a new chart 
file. (FSERR !) 


Meaning 
Same as number 12. 
The language parameter must be 


an integer from 0 to 3. 


Required memory resources are not 
available. 


Internal Error. 
Not enough room in stack for the 
requested DLSIZE. 


Internal error accessing graphics 
device. 


Graphics device couldn't be closed. 


Numcharts parameter must be 
greater than or equal to 1. 


Domain parameter must be 0, 1, 
or 2. 


The file system could not create 
the chart file. 


The file system could not access 
the file. 


The file system could not create 
the chart file. 
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Action 





Same as number 12. 


Change the language parameter. 


Exit the program and rerun when 
necessary resources are available. 
Contact your system manager. 

PREP your program with larger 
MAXDATA. 

See your system manager. 

Refer to MPE file system error. 


Re-run program. If problems, 
contact system manager. 


Change the numcharts parameter 


Change the domain parameter. 


Check the file system error number 
for more information. 


Same as number 23. 


Check the file system error number 
for more information. 


Error Message 


26 Could not write to the 
graphics device. (FSERR !) 


2f Convert chart file to new 
format using GUPDATE utility. 

GCLOSEFILE 

30 No chart file is open. 


31 Record update failed. (FSERR !) 


32 Add record failed. (FSERR !) 
33 Error trying to find a given 
record by key. (FSERR !) 


34 Failed to read a record from 
the chart file. (FSERR !) 


37 Temporary chart file could 
not be closed and purged. 
(FSERR !) 

GOPENFILE 


50 ACCESS parameter must have 
a value of 0, 1, or 2. 


51 Chart file not specified or 
could not be opened. 
(FSERR !) 


52 File is not a chart file. 


Meaning 


Graphics device may not be connec- 
ted or turned on. 


Chart file format has been changed 
in the newest version of DSG/3000. 


There is no current chart file. 
Record update failed due to a file 
system error. 

Add record failed due to a file 


system error. 


Find record failed due to a file 
system error. 


Read record failed due to a file 
system error. 


File close failed due to a file 
system error. 


There is an error in the access 
parameter. 


File open failed due to a file 
system error. 


Specified file was not created by 
GCREATEFILE. 
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Action 





Check to see if graphic device is 

connected correctly and is turned 

on. 

Run GUPDATE program to convert old 


chart file to new chart file format 
so it can be run on the new version. 


No action is necessary. 

Refer to the file system error 
number for more information and 
possible action. 


Same as number 31. 


Same as number 31. 


Same as number 31. 


Same aS number 31. 


Change the access parameter to a 
GO, 15: OF 2. 


Refer to the file system error 
number for more informaton and 
possible action. 


Check the file name and file code. 


Error Message 


53 Chart file needs stack space 
of ! words. Could not expand 
stack. 


54 Could not get the name of the 
previous chart file. (FSERR !) 


55 Could not inquire information 
from the chart file. (FSERR !) 


56 Could not expand stack to size 
of ! words. 


57 INTERNAL ERROR: Could not 
expand stack to size ! words. 


58 Could not expand stack because 
it was frozen. 


GLISTCHARTS 


60 User cannot request less than 
O chart names. 


61 Chart name numbering starts 
with 1. 


62 Index of first chart name 
exceeds current number of 
charts. 

GCREATECHART 


70 Chart ! already exists in 
chart file. 


71 Chart name cannot be all 
blanks. 


72 Chart name must begin with 
a letter. 


Meaning 


Required memory resources are not 
available. 


Product internal error - graf 
area may have been overridden. 


Could not read the chart file due 
to a file system error. 


Required memory resources are not 
available. 


System memory resources are not 
available at this time. 


System memory resources are not 
available at this time. 


You requested fewer than 0 chart 
names. 


You are passing a non positive 
in the firstchart parameter. 


You requested chart names that do 
not exist in the chart file. 


The chart you are trying to create 
already exists. 


You tried to specify a chart name 
that contains all blanks. 


A non alphabetic character begins 
the chart name. 
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Action 





Exit the program and rerun when 
necessary resources are available. 


Check your code to see if it is 
over-writing the graf area. 


Same as number 51. 


Exit the program and rerun when 
necessary resources are available. 


Rerun when required resources are 
available 


Rerun when required resources are 
available. 


Check numcharts parameter. 
Check firstchart parameter. 


Check firstchart parameter. 


Delete the chart before you 
create 


' Check the chartname parameter. 


Check the chartname parameter. 


Error Message 


73 No embedded blanks are allowed 
in chart names. 


74 Chart names can contain only 
letters, numbers and underbars. 


75 Chart file is full. Cannot 


add any more charts. 


76 AGL GPLOTR failed when 
terminating a device. 


77 INTERNAL ERROR: Bad parameter 
to EXPAND'BLOCK. 


78 INTERNAL ERROR: Block table is 
wrong for this record. 


GGETCHART 


80 Chart ! does not exist in this 
chart file. 


GCOMMENTSET AND GCOMMENTINQ 


90 Directory comments area too 
small. No expansion can be 
done. 


91 Chart file must be opened 
exclusively before it can be 
changed. 


92 Length of comments must be 
a positive value. 


Meaning 
Your chart name contains embedded 
blanks. 


Your chart name contains illegal 
characters. 


No more space to add new charts. 
Internal error accessing graphics 
device. 


Internal error. 


Internal error. 


The chartname parameter specifies 
a chart that is not in the current 
chart file. 


No more room in user chart file to 
add comments. 


You cannot write comments to the 
chartfile when the chart file is 
opened with shared access. 


You supplied a negative value as 
the length of your comment string. 





Action 





Check the chartname parameter. 
Check the chartname parameter. 
Delete old charts before adding new 


ones. 


See your system manager. 


Same as number 76. 


Same as number 76. 


Check the name in the chartname 
parameter. 


You can make room by deleting 
some of the other charts in the 
chart file. 


Close the chart file and open it 
again with exclusive access (call 
GCLOSEFILE and GOPENFILE. ) 


Check your code and pass a positive 
value. 


Error Message 


GCHARTYPESET and GCHARTYPEINQ 


100 INTERNAL ERROR: Could not 
find directory entry for 
current chart. 


101 Chart type ranges from 1 to 


102 There is no currently active 
chart. 


GENERAL MESSAGE 
110 This intrinsic not callable 


from COBOL. (real values 
passed. ) 


GPIESET AND GPIEINQ 


120 PERCENT parameter requires 
a value of 0 or 1. 


121 ACTUAL parameter requires 
a value of 0 or 1. 


130 Number of pie segment colors 
ranges from 0 to 30. 


131 Number of pie segment 
textures ranges from 0 to 
30. 


Current chart name does not have 
an entry in the chart fil directory 
(bad chart file). 


The legal chart types range from 1 
to 4. 


The sequence of intrinsic calls is 
in error. 


The intrinsic that was just called 
from a COBOL program is not call- 
able from COBOL because the 
intrinsic requires real number(s) 
to be passed to it. 


The percent parameter does not 
equal 0 or 1. 


The actual parameter does not 
equal 0 or 1. 


The colorlen parameter is not 
between O and 30. Colorlen 
indicates the number of items in 
colorbuf. 


The texturelen parameter is not be- 
tween 0 and 30. Texturelen in- 
dicates the number of items in 


texturelen. 
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Action 





Contact your system manager. 


Check to make sure you are 
passing a valid chart type. 


Call GGETCHART or GCREATECHART to 
establish a currently active chart. 


Call the equivalent intrinsic which 
is callable from COBOL because an 
ASC11 character string (or strings) 
is used instead of real numbe(s). 
For example, call GBARASET instead 
of GBARSET. 


Change the percent parameter. 


Change the actual parameter. 


Change the colorlen parameter. 


Change the texturelen parameter. 


Error Message 


132 Colors range from 0 to 16. 
Item ! illegal. 


133 Textures range from 0 to 8. 
Item ! illegal. 


GLEGENDSET AND GLEGENDINQ 


140 Bars or lines range between 
1 and 8. 


141 Colors range from 0 to 16. 
142 Textures range from 0 to 8. 
143 Markers range from 0 to 8. 


144 Non-printable character 
was found in the legend's 
first line. 


145 Non-printable character 


was found in the legend's 
second line. 


GTITLESET AND GTITLEINQ 


150 Length of string is less 
than 0. 


151 Only a stick font (1) is 
available now. 


152 Length of title cannot 
exceed 45 characters. 


153 Size of subtitle can be 
only big (1) or small (0). 


The specified item in the colorbuf 
parameter is not between 0 and 16. 





Action 





Change the specified color item. 


The specified item in the texturebuf Change the specified texture item. 


parameter is not between 0 and 8. 


You tried to specify more than 8 
lines or bars. 


The color parameter is not between 


0 to 16. 


The texture parameter is not between 


O and 8. 


The marker parameter is not between 


O and 8. 

The legend] parameter contains an 
unprintable character, such as 
escape or tab. 

The legend2 parameter contains an 


unprintable character, such as an 
escape or tab. 


The titlelen parameter is less 
than 0. 


The font parameter must equal 1. 
The titlelen parameter is greater 
that 45. 


The size parameter is not 0 or 1. 
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Change the depvarid parameter. 


Change the color parameter. 
Change the texture parameter to 
0-4, or -1 for the default. 


Change the marker parameter to 
0-8, or -1 for the default. 


Check the contents of the legend! 
parameter. 

Check the contents of the legend2 
parameter. 

Change the titelen parameter. 
Change the font parameter. 


Change the titlelen parameter. 


Change the size parameter. 


Error Message 


154 Length 


exceed 


155 Length 


of subtitle cannot 
64 characters. 


of second line of 


title cannot exceed 45 
characters. 


156 Length 


exceed 


157 Length 
cannot 
158 Length 
cannot 
159 Length 
cannot 
160 Length 
cannot 
161 Title, 
ferred 


of footnote cannot 
90 characters. 


of second footnote 
exceed 90 characters. 


of right axis title 
exceed 90 characters. 


of X axis title 
exceed 90 characters. 


of Y axis title 
exceed 90 characters. 


subtitle etc. re- 
to by numbers from 


1 through 7. 


162 


Length of user's buffer must 


be greater than 0. 


Meaning 


The titlelen parameter is 
than 64. 


greater 


The titlelen parameter is 


greater 
than 45. 


The titlelen parameter is 
than 90. 


greater 


The titlelen parameter is 
than 90. 


greater 


The titlelen parameter is greater 


than 90. 


The titlelen parameter is 
than 90. 


greater 


The titlelen parameter is 
than 90. 


greater 


The option parameter must have a 
value between 1 and 7 inclusive. 


The titlelen parameter is less than 
or equal to zero. 


GTEXTCONTROLSET and GTEXTCONTROLINQ 


175 Title, 


subtitle, etc. 


referred to by numbers 1 
through 11. 


GTERMGRAF 


180 AGL GPLOTR failed with 
terminate function. 


The option parameter indicating 
which text entity will be affected 
must be in the range 1-11 action. 


Internal error on a graphing device 
during termination. 
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Action 





Change the titlelen parameter. 


Same as number 154. 


Same as number 154. 


Same as number 154. 
Same as number 154. 
Same as number 154. 
Same as number 154. 


Change the option parameter. 


Change the titlelen parameter. 


Set option parameter to the code 
number of the entity you want to 
change. 


Abort the program. 


181 


Error Message 


AGL GEND failed. 


GBARSET AND GBARINQ 


190 


191 


192 ORIENTATION parameter must 


193 


194 Interval between grid lines 


GAXISSET AND GAXISINQ. . 


195 


197 


198 


199 


200 


GROUPING parameter must 
have a value of 0 to 2. 


DEFAULTS parameter must 
have a value of 0 to 2. 
have a value of 0 to 2. 
A maximum of 60 bars are 


allowed. 


is too large. 


Logarithmic interval must 
be less than 32767. 


Logarithmic interval size 
must be an integer. 


Bar chart minimum must be 
less than or equal to 0. 


Bar chart maximum must be 
greater than or equal 0. 


Use 1 for independent 
variable axis, 2 for 
dependent axis. 


Internal error on a graphing device 
during termination. 


The grouping parameter is not 
between 0 and 2. 


The defaults parameter is not 
between 0 and 2. 


The orientation parameter is not 
between 0 and 2. 


More than 60 bars were specified 
in the numintevals parameter. 


The gridspacing parameter is larger 
than the numintervals parameter. 


- and GSUPPRESSSET 


The intervalsize parameter is 
greater than or equal to 32767 
for a logarithmic chart. 


The intervalsize parameter is not 
an integer for a logarithmic 
chart. 


The min parameter is greater than 0. 


The max parameter is negative. 


The axis parameter is not 1 or 2. 





Action 





Abort the program. 


Change the grouping parameter. 
Change the defaults parameter. 
Change the orientation parameter. 
Change the numintevals parameter. 


Change either the gridspacing 
parameter or the numintervals 
parameter. 


Change the intervalzise parameter. 


Change the intervalsize parameter. 


Change the min parameter. 


Change the max parameter. 


Change the axis parameter. 


201 


202 


203 


204 


205 


206 


207 


208 


209 


Error Message 


DEFAULTS parameter must 
have some value from 0 
to 4. 


NOTICKS parameter must be 
either 1 or 0. 


Maximum number of minor 
tick marks per major tick 
marks =10. 


SCALETYPE parameter must 
have a value from 0 to 2. 


REFLECT parameter must have 
a value of 0 or 1. 


Minimum must be less than 
maximum. 


MINORGRIDS parameter must 


be either O or 1. 


Logarithmic minimum must be 
greater than 0. 


Logarithmic maximum must be 
greater than 0. 


GSUPPRESSET 


210 


211 


CHART suppress parameter 
must be either 0 or 1. 


LABELS suppress parameter 
must be either 0 or 1. 


Meaning 


The defaults parameter is not be- 
tween 0 and 4, inclusive. 


The noticks parameter does not 
contain a 0 or 1. 





Action 





Change the defaults parameter. 


Change the noticks parameter. 


The minorticks parameter is greater Change the minorticks parameter. 


than 10. 


The scaletype parameter has a value Change the scaletype parameter. 


other than 0,1, or 2. 


The reflect parameter must be either Change the reflect parameter. 


O or 1. 


The value of the min parameter must Change either the min or max 
be less than the value max parameter .parameter. 


The minorgrids parameter does not 
contain a 0 or 1. 


The min parameter is negative or 0 
on a logarithmic chart. 


The max parameter is negative or 0 
on a logarithmic chart. 


The specified chart parameter has 
a value other than 0 or 1. 





The specified labels parameter has 
a value other than 0 or 1. 


C-il 


Change the minorgrids parameter. 


Change the min parameter. 
Logarithms of negative numbers or 

O are meaningless. The value 1 is a 
a good minimum;the logarithm of 1 
is zero. 


Change the max parameter. 
Logarithms of negative numbers or 0 
are meaningless. 


Change the chart parameter. 


Change the labels parameter. 


Error Message 


212 AXES suppress parameter 
must be either 0 or 1. 


213 LEGENDS suppress parameter 
must be either O or 1. 


214 TITLES suppress parameter 
must be either 0 or 1. 


215 FRAME suppress parameter 
must be either 0 or 1. 


216 DATA suppress parameter 
must be either O or 1. 


217 ADVANCE suppress parameter 
must be either 0 or 1. 


GAXISSET 


218 The minimum for stacked 
bar charts must equal 0. 


GDEVICESET 

220 COPIES must be >=0. 

221 PENSPEED must be either 
fast (0) or slow (1). 


222 Character type may have a 
value of 1 or 3. 


223 HPIB address must fall 
between O and 31. 


The specified axes parameter has a 
value other than 0 or 1. 





The specified legends parameter has 
a value other than O or 1. 


The secified titles parameter has 
a value other than 0 or 1. 





The specified frame parameter has 
a value other than 0 or 1. 





The specified data parameter has a 
value other than 0 or 1. 





The specified advance parameter 
has a value other than 0 or 1. 


The min parameter is not 0 for a 
Stacked bar chart. 


The specified copies parameter is 
negative. 


The penseed parameter has a value 
other than 0 or 1. 


The chartype parameter has a value 
other than 7 or 3. 


Valid HPIB addresses are from 0 to 
31. 
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Action 





Change the axes parameter. 
Change the legends parameter. 
Change the titles parameter. 
Change the frame parameter. 
Change the data parameter. 
Change the advance parameter. 
Change the min parameter to 0. 
Stacked bar charts add data 
values to a bar which starts at 


a certain base value; this base 
value must be zero. 


Change the copies parameter to 0 or 
a positive number. 
Change the penspeed parameter. 


Change the chartype parameter. 


Change the HPIB parameter. 


Error Message 


224 DSG/3000 does not support 
such a device. 


225 "FIGURE" cannot be specified 
VIA GDEVICESET. 


GLIMITSET 


230 LIMITS parameter may have a 
value of 0 to 4H. 


GLABELSET AND GLABELINQ 


235 Type of labels may range 
from 0 to 3. 


236 Length of label must be > 0. 

237 Number of labels in buffer 
must be > 0. 

239 Unprintable character in 
labels buffer. 

240 No room for labels. Stack 


could not be expanded. 


241 AXIS parameter ranges 
from 1 to 3. 


243 Length of labels buffer 
must be > o. 


244 Only the X axis variable 
can be labeled from the 
data. 


Meaning 


The device parameter specifies a 
device not supported by DSG/3000. 


"FIGURE" is not a valid graphics 


device as a parameter to GDEVICESET. 


The limits parameter has a value 
other than 0-4. 





The type parameter has a value 
other than 0 to 3. 


The labelen parameter has a 
negative value. 


The numlabels parameter has a 
negative value. 


The labelbuf parameter contains 
an unprintable character such as 
escape or tab. 


Required memory resources are not 
available. 


Axis parameter has a value other 
than 1 2, or 3. 





The labelen parameter of 
GLABELINQ must have a positive 
value. 


The axis parameter has a value 2 


and the type parameter has a value 
1. 
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Action 





Change the device parameter. 





To draw to a figure file, use the 
GEXECFIGURE intrinsic. 


Change the limits parameter. 


Change the type parameter. 


Change the labelen parameter. 


Change the numlabels parameter. 


Check the contents of the labels 
buffer. 


Exit and rerun program when 
necessary resources are available. 


Change the axis parameter. 


Change the labelen parameter. 


Change the typeor axis parameter. 


Error Message 


245 One label cannot exceed 25 
characters in length. 


ANNOTATIONS ERRORS 


250 Annotation identifiers must 
be >=0. 


251 Legal symbol types range 
from 1 to 3. 


252 First X coordinate for 
annotation must be >=0. 


253 First Y coordinate for 
annotation must be >=0. 


254 Second X coordinate for 
annotation must be > =0. 


255 Second Y coordinate for 
annotation must be >=0. 


256 Linetypes range from 0 to 8. 


257 No room in primary 
annotation table. 


258 Annotation already exists. 


259 No such annotation exists. 


260 Use GTEXTINQ to look at 
annotations of type TEXT. 


Meaning 


The labelen parameter is greater 
than 25. 


No negative numbers are allowed for 
annotation identifiers. 


Symbol parameter must be either 1 
2, or 3 


You cannot use negative numbers 
as coodinates. 

Same as number 252. 

Same as number 252. 


Same as number 252. 


The linetype parameter is wrong. 


No more annotations can be added. 


A duplicate annotation identifier 
has been specified. 


The annotation identifier does not 
exist in the current chart. 


The annotation you are inquiring 
about is textual. 
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Action 


Change the labelen parameter. 


Change the annotid parameter to a 
positive number. 


Change the symbol parameter. 
Change the X1 paraeter. 
Change the Y1 parameter. 
Change the X2 parameter 
Change the Y2 parameter. 


Change the linetype parameter to be 
an integer from 0 to 8, or -1 to 
accept the default. 


Delete one of the existing 
annotations. 


Change the annotid parameter or 
delete the annotation with the 
matching identifier. 

Change the annotid parameter. Call 
GANOTINFO for more information. 


Call GTEXTINQ. 


Error Message 


261 Cursor position out of 
graphing area. 


262 Error occurred in setting up 
the plotting environment. 


263 Error occurred in drawing 
the current annotation. 


GTEXTSET AND GTEXTINQ 


265 LORG parameter must hold 
value ranging from 1 to 
9. 


266 ANGLE ranges from 0 to 
359 degrees. 


267 Character size ranges 
from 1 to 50. 


268 Length of buffer holding 
annotation text must be 
>0. 


269 Unprintable character 
occurred in the annotation 
text. 


270 Only the stick character 
font (1) is allowed. 


2/2 The length of textual an- 
notations is limited to 100. 


Meaning 


The cursor was out of the currently 
defined graphics area when the 
cursor was read, i.e., when the key 
was pressed to enter the cursor 
location. 


The graphics output device failed 
to return the plotting environment 
for the annotation. 


The current annotation could not 
be completed. 


The label origin is specified by an 
integer from 1 to 9. 


The angle parameter must be an 
integer from 0 to 359. 


The charsize parameter must be an 
integer from 1 to 72. 


You passed a value for textbuflen 


that was 0 or negative. 


The textbuf parameter contains an 
unprintable character, such as an 
escape or tab. 


The font parameter must be equal 
LOT 


The textlen parameter is greater 
than 100. 
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Action 





Try again, but make sure the cursor 
falls within the previously defined 
graphing area (see GLIMITSET and 
GLIMITINQ). 


Make sure that the device is 
configured properly and set up for 
plotting. 


Check the parameters of the current 
annotation. 


Change the lorg parameter. 


Change the angle parameter. 


Change the charsize parameter. 


Change the textbuflen parameter to 
a positive integer. 


Check the contents of the text 
buffer. 


Change the font parameter. 


Change the textlen parameter. A 
long(> 100 character) annotation 
may need to be divided into 2 or 
more annotations. 


Error Message 


GANOTINFO 


275 Index into the annotations 
must be > =1. 


276 Length of user's buffers 
must be >0. 


277 Secondary annotation table 
full. Stack could not be 
specified. 


278 The index into the an- 
notations exceeds the 
number of annotations. 


CONVERSION ERRORS 


280 ASCII real number was all 
blanks. 


281 ASCII real number must 
contain digits as well 
aS a Sign. 


282 ASCII real number cannot 
start with a conma. 


283 Commas must be spaced 3 
digits apart. 


284 The exponent is missing 
although the "E" appears 
in the number. 


285 The exponent cannot have 
more than one sign. 


286 An exponent sign appears 
although no "E" is given. 


Meaning 


The firstannot parameter must be 
an integer greater than or equal 
to 1. 


The maxannots parameter must be 
greater than 0. 


No more textual annotations can be 
entered. 


The firstannot parameter is greater 
than the total number of annotations 
for this chart. 


A value of an ASCII string. was all 
blanks. 


A value of an ASCII string contained 
no digits. 
A specified value of an ASCII string 


starts with a comma. 


A specified ASCII string has mis- 
placed commas. 


A specified ASC11 string contains 
an E but is not followed by an 
exponent. 


A specified ASCII string has more 
than one sign in the exponent. 


The sign of the exponent is not 
preceded by an E in an ASCII string. 
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Action 





Change the firstannot parameter. 


Change the maxannots parameter. 


Delete one or more textual 
annotations. 


Change the firstannot parameter. 


Change the string parameter to 
contain at least one digit. 


Change the string parameter to 
contain at least one digit. 
Change the string parameter so that 


it does not start with a comma. 


Change the spacing of commas to 
be 3 digits apart. 


Put the value of the exponent after 
the E, or delete the E. 


Delete the extra sign(s). 


Put an E before the sign of the 
exponent. 


287 


288 


289 


290 


291 


292 


293 


294 
295 


296 


297 


Error Message 


The exponent sign cannot 
trail the exponent. 


Only one decimal point is 
allowed. 


Only one "E" is allowed. 


No mantissa or exponent 
was given. 


A blank was embedded in 
the real number. 


Only 0-9, +,-,-, "E",and/or 


commas are allowed in 
real numbers. 


Mantissa or exponent is 
missing. 


EXTIN' failed. 


INTERNAL ERROR: Buffer 
too short to return E- 
type number. 


INTERNAL ERROR: Buffer 
too short to return free 
format. 


Number too big to convert 
and contains illegal 
character. 


Meaning 


The sign must precede the value of 
the exponent in an ASCII string. 


An ASCII string has more than one 
decimal point. 


An ASCII string has more than one 
E. 


An ASCII string is missing either 
a mantissa or exponent; i.e., no 
digits appear either before the 
"E" or after the "E", 


The real number contained a blank. 


A specified ASC11 string contains 
illegal values. 


An ASC11 string is missing either 
a mantissa or an exponent. No 
digits appear either before the 
"E" or after the "E". 


Internal error on conversion. 


Internal error on conversion. 


Same as number 295. 


The ASCII string contains a number 
larger than the largest possible 
real number and at least 1 illegal 
character. 





Action 





Put the sign before the value of the 
exponent. 
Delete the extra decimal point(s). 


Delete the extra E. 


Add digits or delete the "E", as 
desired. 


Remove the blank. 


Change the value of the string 
parameter. 


Add digits or delete the "E", as 
desired. 


Contact your system manager. 


Contact your system manager. 


Same as number 295. 


Change the ASCII string to 
represent a legal value. 


Error Message 


298 Number too small to convert 
and contains illegal 
character. 


299 Number too big to convert 
to real. 


300 Number too small to convert 
to real. 
GCHARTINFO 


310 INTERNAL ERROR: Converting 
CHRONOS to JULIAN. 


311 INTERNAL ERROR: Converting 
JULIAN to TEXT. 


GCOPYCHART 


320 FROM FILE name is not a legal 
file name. 


321 TO FILE name is not a legal 
file name. 


322 No such chart exists in the 
FROM FILE. 


Meaning 


The ASCII string contains a number 
smaller than the smallest possible 
real number and at least 1 illegal 
character. 


The number in the ASCII string is 
larger than the largest possible 
real number. 


The number in the ASCII string is 
smaller than the smallest possible 
real number. 


Internal date conversion error. 


Internal date conversion error. 


The fromfile parameter does not 
meet the MPE restrictions for a 
legal file name. 


The tofile parameter does not meet 
the MPE restrictions for a legal 
file name. 





The fromchart parameter names 

a chart which does not exist in 
the file designated by the 
fromfile parameter. 





Action 





Change the ASCII string to represent 
a legal value. 


Change the ASCII number to repre- 
sent a legal value. 


Change the ASCII number to repre- 
sent a legal value. 


Contact your system manager. 


Contact your system manager. 


Change the fromfile parameter to a 
legal MPE file name. It should also 
be the name of an existing chart 
file. 


Change the tofile parameter to a 
legal MPE file name. 





Check the chart file using the 
browse option of the GRAPH program. 
Usually, either the chart name is 
mispelled or the wrong chart file 
file was specified. Change the 


fromfile or fromchart parameter as 


appropriate. 


Error Message 


323 INTERNAL ERROR: Could not 
find char ! after it was 
copied. 


INTERNAL FILE ERRORS 


340 A file already exists with 
this name. 


341 INTERNAL ERROR: File access 
failed. (KKA ERROR !) 


342 INTERNAL ERROR: Failed to 
close chart file properly. 
(FSERR !) 


343 INTERNAL ERROR: Chart file 
was not closed properly. 


344 INTERNAL ERROR: Update 
failed due to file access 
problem. 


345 Chart file is full. 
add any more charts 
(KKA error.) 


Cannot 


346 INTERNAL ERROR: Retrieve 
failed due to file access 
problem. 


GEXECHART 


400 OPTIMIZE parameter must hold 
0 or 1 for chart ! 


401 No data file is open for 
chart (!). Call GEXECDATA. 


Chart file directory error after 
the copy completed. 


A file of this name already exists. 
Internal error. 


Internal error. 


Internal error. 


Same as number 343. 


Same as number 343. 


Same as number 343. 


The optimize parameter is not set 
to 0 or 1. 


Gexecdata was not called to exe- 


cute all data specifications. 





Action 





Try again using a different desti- 


nation chart file. 


Purge file and rerun. 


Contact your system manger. 


Contact your system manager. 


Contact your system manager. 


Same as number 343. 


Same as number 343. 


Same as number 343. 


Set optimize to 1 for optimize or to 
0 for no optimization. 


Call gexecdata before calling 
gexechart. 


402 Could not read from data file 


405 


409 


410 


441 


412 


413 


415 


416 
420 


425 


Error Message 


for chart (!). (FSERR !) 
INTERNAL ERROR FOR CHART !: 
No such chart type. 


Failed to open figure file!. 
(KKA ERROR !) 


Failed to open graphics 
terminal for chart!. 


Chart ! requires the use 
of a graphics terminal. 


Failed to open graphics 
device for chart!. 


AGL GCLEVEL failed for 
chart !. 


Could not open graphics 
device for chart!. (FSERR!) 
Could not read from graphics 
device for !. (FSERR !) 

AGL GCLR failed for chart !. 


INTERNAL ERROR FOR CHART ! : 
No such label option. 


Meaning 


Internal software error, not under 
user control. 


Internal software error, not under 
user control. 


Figure file is busy or is not 
present. 


Graphics terminal cannot be opened 
or is not pesent. 


Hit draw on non-graphics terminal. 





Action 





See file system error number for 
error information. Contact your 
system manager. 


Contact your system manager. 


List your files to see if the 
particular file is present; if 

it is, check to see if it is being 
used elsewhere. 


Check the specified device to en- 
sure it matches the current terminal 
If not, rerun using the current 
configuration. 


Use a 2647 or 2648 terminal. 


The graphics device associated with Check the specified device to 
the indicated chart either cannot be ensure it matches the current 


opened or is not connected correctly.device. 


Reconnect the device 
and rerun if necessary. Other- 
wise contact your system managr. 


Internal error with graphics device, Contact your system manager. 


not under user control. 


Graphics terminal cannot be opened 
or is not present. 


If the specified device matches the 
current configuration, contact your 
system manager. 


Internal error with graphics device. Contact your system manager. 


Internal error with graphics device, Contact your system manager. 


not under user control. 


Internal software error, not under 
user control. 
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Contact your system manager. 


eee 


Error Message 


Meaning 


Action 


Fa a ee ee 


430 


432 


435 


436 


437 


440 


444 


442 


450 


451 


452 


454 


Lower left corner must be 
lower than the upper right 
corner. 


AGL GPAPERSIZE failed for 
chart !. 


AGL GDMAP stretch failed 


AGL GDMAP square failed 
for chart !. 


INTERNAL ERROR FOR CHART ! : 


No such chart format. 


Pie chart ! cannot be 
positioned by its data 
boundary. 


The number of pie segments 
exceeds the maximum 
allowed (!). 


Pie segments less than 2 
degrees are not allowed. 


AGL GVIEWP failed for 
chart!. 


AGL GWINDOW failed for 
chart !. 


AGL convert to NDC's failed 
for chart !. 


AGL GLORG failed for chart !. 


The lower left coordinates of the 
plotting area are higher than upper 
right coordinates. 


Internal error with graphics device, 


Internal error with graphics device, 


not unde user control. 


Same as number 435. 


Same as number 435. 


The data plotting area for a pie 
chart cannot be changed. 


Data exists for more pie segments 
than can be drawn. 


One or more data values would 
cause a segment of less than 2 
degrees to be drawn, i.e., a data 
value is less than .6% of the total 
for all the data values. 


Internal error 
not under user control. 


Same as number 450. 


Same as number 450. 


Same as number 450. 


with graphics device, 


Respecify coordinates to place 
lower left below and to left of 
upper right. 

Contact your system manager. 
Contact your system manager. 
Same as number 435. 


Same as number 435. 


Change the chart plotting area for 
the pie chart. 


Reduce the number of segments by 
modifying the data file or using 
data subsetting. 


Remove the small data values by 
modifying the data file or using 
data subsetting. 


Contact your system manager. 


Same as number 450. 


Same as number 450. 


Same as number 450. 


Error Message 


455 AGL GLDIR failed for chart !. 


456 AGL GCELLSIZE failed for 
chart!. 


457 AGL GMOVE failed for chart!. 


458 AGL GTEXT failed for 
chart !. 


459 AGL GPEN failed for chart !. 
460 AGL GLSTYLE failed for 
chart!. 


462 AGL GXMIT failed for chart!. 


467 AGL GCFONT failed for chart!. 


468 AGL GFILLPOCY failed for 
chart!. 


469 AGL GDEFFONT failed for 
chart !. 

470 Floating point error 

occurred. Data cannot 

be graphed. 

471 Overflow on bar scaling due 

to interval size based on 

data. 


472 Bars cannot be drawn because 
too many intervals are 


present. 


Meaning 


Same as number 450. 


Same as number 450. 


Same as number 450. 


Same as number 450. 


Internal error 
not under user 


with graphics device, 
control. 


Same as number 459. 


Same as number 459. 


Incorrect font number specified. 
Graphics package has not been 
initialized. 

One or more font attributes is 
is invalid. 


A floating point error occurred 
while drawing the chart. 


Internal error caused by scaling. 


Too many intervals present 
probably due to the intervalsize 
parameter on GAXISSET. The 
intervals are so small, bars can- 
not be drawn within them. 
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Action 


Same as number 450. 


Same as number 450. 


Same as number 450. 


Same as number 450. 


Contact your system manager, 


Same as number 459. 


Same as number 459. 
Font number must be between 1-4. 


Contact your system manager. 


Check parameters for GFONTSET, and 
make sure font file exists. 


Check the data file, transformations 
qualifications, and subsetting for 
possible errors. 


Change the interval size, minimun, 
and maximum scaling parameters; 
insure all data falls between the 
bounds specified. 


Check interval size, minimum and 
maximum values; insure that the 
number of evenly-spaced intervals is 
a reasonable number, i.e., 1 to 40. 


Error Message 


473 AGL GPLOTR failed to 
to initialize the 2680. 


480 Error occurred when plotting 
to the 2680 (FSERR! 


481 IFS/3000 error occurred when 


plotting to the 2680. (IFSERR! ) 


482 File system error occurred on 


OUT2680A. 


483 CREATEPROCESS error occurred 
when plotting to the 2680 
(ERRNUM! ) 


490 Font file format for font ! 
is bad for chart ! 


492 Font file cannot be opened 
for chart!. 


404 No font file for font! 
available for chart!. No 
best fit. 


500 Could not draw frame for 
chart !. 


501 Could not draw axes for 
chart !. 


502 Could not fill an area 
for chart !. 


505 Could not draw a box for 
the legend for chart !. 





Meaning 


Same as number 450. 


A file system error occurred while 


plotting to the 2680. No raster 


image is produced. 


Same as number 450 


Same as number 480 


Same as number 450 


Specified file is not a valid 
DSG/3000 font file. 


Font file is unavailabe. 

The font file could not be 
found or opened for font number 
N, and the best fit font file 
used for finding best fit was 


also unavailable. 


Same as number 459. 


Same as number 459. 


Same as number 45 


Same as number 459. 


Action 





Same as number 450. 


Look up the file system error and 
take the appropriate action. 


Same as 450. 


Same as number 480. 


Same as number 450. 


Use valid DSG/3000 font files. 
Check the file name, make sure it 
exists and is the proper file type. 


The best fit font file should be 
be provided during DSG/3000 
installation. Contact your system 
manager . 


Same as number 459. 


Same as number 459 


Same as number 459 


Same as number 459 


Error Message 


506 


509 


510 


511 


512 


513 


514 


515 


517 


518 


INTERNAL ERROR FOR CHART! 
: Too many legends for this 
format. 


Maximum value may not equal 
zero for stacked bar charts. 


INTERNAL ERROR FOR CHART ! 
No such scaling option 
possible. 


INTERNAL ERROR FOR CHART !: 
No such scaling option 
possible. 


INTERNAL ERROR FOR CHART !: 
No such axis exists. 


Minimum must be less than 
maximum for scaling chart!. 


At least one scaling interval 
must be requested for chart!. 


Minimum must be less than 
maximum for scaling chart!: 


Stacked bar chart ! Cannot 
have data points below QO. 


Negative or O data not 
acceptable for log values 
on chart!. 


Meaning 


Same as number 459. 


The maximum scale on a stacked 
bar chart is set to 0 or less, 
probably due to the max parameter 
with GAXISSET. 


Same as number 459. 


Same as number 459. 


Same as 459. 


The minimum scaling value is 
greater than the maximum scaling 
value. 


The default number of intervals 
is less than or equal zero. 


Min is greater than max. 


Negative data points cannot be 
accurately displayed by a stacked 
bar chart. 


The log of negative numbers cannot 
be calculated. 
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Action 





Same as number 459. 


Change the maximum for the axis to 
a positive value greater than the 
data to be plotted. Remember that 
stacked bars add data to a base 
value of 0. 


Same as number 459. 


Same as number 459. 


Same as number 459. 


Reset the minimum or maximum to have 
minimum less than maximum. 


Change the axis scaling by either 
calling GAXIS[A]SET using the 
GRAPHICS OPTIONS Menu interactively. 


Make max greater than min. 


Use a clustered bar chart instead. 


Use ABS function in transformations 
to compute absolute values. 


Error Message 


519 


530 


531 


532 


533 


534 


535 


536 


537 


540 


Stacked bar charts not 
allowed with logarithmic 
scaling. 


Failed to pick up a pen for 
chart !. 


Could not draw bar between 
minimum and maximum for 
chart!. 


Negative data is not 
acceptable for stack 
bar chart!. 


Could not draw bar between 
minimum and maximum for 
chart!. 


Could not draw the zero line 
for cluster bar chart!. 


Could not draw grid lines 
between horizontal bar 
for chart! 


Could not draw bar between 
minimum and maximum for 
chart!. 


Could not draw bar between 
minimum and maximum for 
chart!. 


Could not draw vertical grid 
lines for chart!. 


Meaning 


Stacked bar charts cannot be 
accurately displayed using log 
scaling. 


Internal graphics device error, not 
under user control. 


Axis scaling did not permit entire 
bar segment to be drawn. 


Negative data points cannot be 
accurately displayed by a stacked 
bar chart. 


Axis scaling did not permit entire 
bar segment to be drawn. 


Zero line for bar chart which falls 
above and below axis could not be 
drawn due to an internal device 
error. 


Grid line(s) failed the specified 
chart due to an internal device 
error. 


Axis scaling did not permit entire 
bar segment to be drawn. 


Axis scaling does not permit entire 
bar to be drawn. 


Grid lines for the specified chart 
failed due to an internal device 
error. 





Action 





Use clustered bar chart. 


Contact your system manager. 


Set min lower, and max higher, or 
let them both default to data. 


Use clustered bar chart. 


Set min lower, or max higher, or 
let them both default to data. 


Contact your system manager. 


Contact your system manager. 


Set min lower, or max higher, or let 
them both default to data. 


Set min lower, max higher, or let 
them both default to data. 


Contact your system manager. 


Error Message 


541 Could not draw minor tick 
marks for chart!. 


542 Could not draw major tick 
marks or grid lines for 
chart!. 


LABELING 


550 Only the bar axis can be 
labeled from the data for 
chart!. 


551 Real number free format 
conversion failed for chart!. 


552 INTERNAL ERROR FOR CHART!: 
Non-fraction too big to 
convert. 


553 Real number exponential 
conversion failed for 
chart!. 


554 Real number too big to fit 
into 6 character label for 
for chart!. 


560 Could not move to first point 
for line chart!. 


561 Could not draw a line segment 


for line chart!. 


562 Call to AGL routine GMARKER 
for chart!. 


563 Could not draw line for 
legend for chart!. 


The minor tick marks or grid lines 
failed due to an internal device 
error. 


The major tick marks or grid lines 
failed due to an internal device 
error. 


Line charts may not use data in 
data file for tick labels. 


Internal error in conversion 
routines. 


Internal error on conversion. 


Internal conversion error of data 
to a label. 


Real data value is too large for 
the 6-character label. 


AGL internal error. 
AGL internal error. 
AGL internal error. 


AGL internal error. 
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Action 





Same as number 540. 


Same as number 540. 


Make a bar chart instead. 


Use different axis scaling. 


Contact your system manager. 


Contact your system manager. 


Change label definition to not use 
data values. 


Contact your system manager. 


Contact your system manager. 


Contact your system manager. 


Contact your system manager. 


Error Message 


570 


571 


bie 


573 


574 


575 


576 


578 


579 


580 


581 


582 


Could not position or draw 
a segment label for chart!. 


Could not convert a per- 
centage into ASC11 for 
labeling chart!. 


Data point could not be 
converted to label for 
chart!. 


Numeric labels are not used 
for pie chart!. 


Data points too small and/or 
numerous for pie chart!. 


No data points exist for 
chart!. 


Could not draw a pie 
segment for chart!. 


Negative values present on 
pie chart!; cannot be drawn. 


There is no data>0O for pie 
chart!. 


Call to GDIGIT did not 
return an annotation 
point for chart!. 


Could not draw a box 
annotation for chart!. 


Could not draw a line 
annotation for chart!. 


Meaning 
AGL internal error. 


Internal error in conversion 
routines. 


Internal error in conversion 
routines. 


Labels for pie charts must be 

type text. 

The data contained values all of 
which converted to segments of less 
than 1 degree in size. 

No data is in the data file. 
Internal error accessing graphics 
device. 

Pie charts cannot be used to dis- 
play negative values. 


The data file is empty. 


AGL internal error. 


Same as number 580. 


Same as number 580. 





Action 





Contact your system manager. 


Contact your system manager. 


Contact your system manager. 


Change the variable to be used as a 
label. 


Change the data or use a 
different chart type. 


Enter the desired data into the 
data file. 


Contact your system manager. 


Use ABS function in trans-~ 
formations to calculate 
absolute value. 

Enter data into the data file. * 


Contact your system manager. 


Same as number 580 


Same as number 580. 


Error Message 


583 


584 


Could not draw a text 
annotation for chart!. 


Could not draw an arrow 
annotation for chart!. 


GFONTSET 


620 


621 


622 


750 


760 


761 


762 


763 


764 


765 


766 


Language may range from 0 
to 7. 

Slant must equal 0. 
Character format must 


equal OQ. 


Switch parameter must be 

Oor 1. 

AGL GALPHACURSON failed. 

AGL GALPHACURSOFF failed. 
AGL GALPHADISPON failed 

AGL GALPHADISPOFF failed. 
AGL GGRAPHCURSON failed. 


AGL GGRAPHCURSOFF failed. 


AGL GGRAPHDISPON failed. 


Meaning 
Same as number 580. 


Same as number 580. 


The language parameter has a 


value other than 0-7. 


Slant option is not supported 


at this time. 


Extended character format 


supported at this time. 


Internal error. 


Problem with the graphics 


Problem with the graphics 


Problem with the graphics 


Problem with the graphics 


Problem with the graphics 


Problem with the graphics 


Problem with the graphics 


is not 


terminal. 


terminal. 


terminal. 


terminal. 


terminal. 


terminal. 


terminal. 





Action 





Same as number 580. 


Same as number 580. 


Change the language parameter. 
Always use 0 for slant 
parameter. 


Always use 0 for character format. 
Call system manager. 
Verify that graphics terminal is 


working properly. 


Verify that graphics terminal is 
working properly. 


Verify that graphics terminal is 
working properly. 


Verify that graphics terminal is. 
working properly. 


Verify that graphics terminal is 
working properly. 


Verify that graphics terminal is 
working properly. 


Verify that graphics terminalis 
working properly. 


Error Message 
767AGL GGRAPHDISPOFF failed. 
768 AGL GKBLOCK failed. 


769 AGL GKBUNLOCK failed. 
770 AGL GMCURS failed. 


GTRANSINQ, GDEFNINQ 


806 Invalid start index. Must 
be larger than zero. 


807 Invalid retrieval maximum. 
Must be positive. 


GSORTSET 


820 Sort value must be O for OFF 
or 1 for ON. 


GDATAFILESET 

830 Missing data value length 
must be in the range of 
! to ! 

831 Missing data value must be 
numeric. 


832 Data file name incorrectly 
specified. 


Meaning 
Problem with the graphics terminal. 
Problem with the graphics terminal. 


Problem with the graphics terminal. 


Problem with the graphics terminal. 


The firstdefn or firstrans parameter 
is negative or zero. 


Numdefn or numtrans parameter is 
negative or zero. 


Sortflag parameter is not 0 or 1. 


Misslen parameter is negative. 


The missbuf parameter contains 
an ASC11 value that cannot be con- 
verted to a real number. 


FILENAME does not follow MPE data 


file naming conventions or a blank 
doesn't follow the name. 
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Action 
Verify that graphics terminal is 
working properly. 


Verify that graphics terminal is 
working properly. 


Verify that graphics terminal is 
working properly. 


Verify that graphics terminal is 
working properly. 


Change firstrans or firstdefn to be 
a positive number greater than zero. 


Change numdefn or numtrans parameter 
to be greater than zero. 


Set sortflag to 0 or 1. 


Set misslen to be in range 0 to 16. 


Change missbuf to be a numeric 
value. 


See MPE naming conventions and 
put a blank following the name. 


Error Message 


GDEFNSET 


Meaning 


840 Invalid number of definitions. Numdefn parameter is negative. 


841 Invalid data format specified. Format parameter is not 1 or 2. 


842 Invalid data type specified. 


843 Column numbers must be in the 


range of ! to !. 


844 Offsets must be in the range 


of ! to !. 


845 Lengths must be in the range 


of ! to !. 


846 Too many variable definitions. 


GTRANSET 


860 Invalid number of trans- 
formations. 


861 Invalid transformation 
expression length. 


862 Too many variable trans- 
formations. 


GDEPVARSET 


870 Invalid number of Y axis 
variables. 


871 Invalid qualification 
length. 


Typebuf parameter is not 1 or 2. 


Column numbers are less than 1 or 
greater than 100. 


Fixed format offsets are less than 
O or greater than 2000. 


Fixed format lengths are less than 1 
or greater than 45. 


Numdefn parameter is greater than 
9. 


The numtrans parameter is negative. 


Exprlen parameter is negative. 


The numtrans parameter is greater 
than 10. 


Numvars parameter is negative or 
greater than 8. 


The qualen parameter is negative. 
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Action 





Reset numdefn to a positive value 
between 0 and 9. 


Set format to 1 or 2. 
Set typebuf to 1 or 2. 


Respecify columns to be in range 
of 1 to 100. 


Set offsets to be in range of 1 to 
2000. 


Set lengths to be in range of 1 to 
45, 


Set numdefn to a value between O and 
9. 


Set numtrans to be in the range of 0 
to 10. 


Set exprilen to be greater than or 
equal to zero. 


Set numtrans to be in range of 0 
to 10. 


Set numvars to a value in the range 
of 0 to 8. 


Set qualen to a positive number or 
zero. 


Error Message 


872 Qualifications are too large. 


GSUBSET 


880 Subset expression has 
invalid length. 


881 Subset expression is too 
large. 


VARIABLE SEMANTIC ERRORS 

1000 Duplicate variable name. 

1001 Duplicate found in trans- 
formed variable list. 


1002 Variables may not be 
redefined. 


VARIABLE SYNTAX ERRORS 


1010 A variable name is required 
here. 

1011 Variable names can contain 

only alphas, digits, "-" ! 

s, and "" 's, 


1012 Variable names cannot have 
embedded blanks. 


1013 A variable name must start 


with an alphabetic character. 


1014 Incorrectly specified 
variable name. 


Meaning 


Insufficient room in chart file to 
hold number of specified quali- 
fications. 


Subsetlen parameter is negative. 


Subsetlen parameter is greater than 
100 bytes. 


More than 1 variable with the same 
name. 


Defined a variable with the same 
name as a transformed variable. 


Defining a transformed variable 
with the same name as a variable. 


Variable name is all blanks. 


Variable name contains characters 
other than ALPHAS, digits, "—" 's, 
or Ww off ts, 


Variable name contains embedded 
blanks. 


Variable name doesn't start with an 
alphabetic character. 


Variable name doesn't follow naming 
conventions. 
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Action 





Reduce size of qualifications: 

Shorten variable names, remove 

embedded blanks, shorten quali- 
fications so that qualen can be 
shorter. 


Set subsetien to a number in the 
range of 0 to 100. 


Set subsetlen to a number in the 


range of 0 to 100. 


Change variable names until each 
is unique. 


Change variable name to be unique 
from transformed variable names. 


Change transformed variable name 
to be unique from variable names. 


Specify a variable name. 


Remove illegal character(s) from 
variable name. 


Remove embedded blanks from variable 
name. 


Change variable name to begin with 
an alphabetic character. 


Specify variable name to conform to 
syntax specified in Section 3. 





Error Message 


Meaning 


Action 


OT RS erry rserasereonceneeuate 


1015 Variable names cannot be 
reserved words. 
EXPRESSION ERRORS 


1101 Expression not completed. 


1102 Expression can't be blank. 


1103 A left parenthesis "(" 
cannot follow "!". 


1104 A right parentheses ")" 
cannot follow "!". 


1105 A minus sign "-" cannot 
follow "!". 


1106 Exponent operator "##" 
eannot follow "!", 


1107 Multiply operator "##" 
cannot follow "!". 


1108 Divide operator "/" cannot 
follow "!. 


1109 Plus operator "+" cannot 
follow "!". 


1110 "!" is not a usable number. 


1111 "!" eannot be used here. 


Variable name is one of the follow- 
ing: AND, OR, NOT, LOG, ABS, 
CUMULATE, LN, MOD, MOVEAVG or SQRT 


SUBSET, QUALIFICATIONS, or TRANS- 
FORMATIONS expression requires 

more information to be complete. 
TRANSFORMATIONS exprssion is 
unspecified. 

Left parenthesis is out of context. 
Right parenthesis is out of syntax 
context. 

Minus sign is out of syntax context. 
Exponent operator is out of syntax 


context. 


Multiply operator is out of syntax 
context. 


Divide operator is out of syntax 
context. 


Plus operator is out of syntax 
context. 


The number is less than -1.15792E-77 
or greater than 1.15792E+77. 


An illegal character was specified. 
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Change variable name to be unique 
from reserved words. 


Change expression to conform to 
syntax rules specified in section 
3. 


Specify a transformation expression 
or remove transformation variable 
names, 


See section 3 of reference manual 
for correct syntax. 


See section 3 of reference manual 
for correct syntax. 


See section 3 of reference manual 
for correct syntax. 


See section 3 of reference manual 
for correct syntax. 


See section 3 of reference manual 
for correct syntax. 


See section 3 of reference manual. 
for syntax rules. 


See section 3 of reference manual 
for syntax rules. 


Change number to be in range of 


Remove illegal character and see 
section 3 for legal specifications. 


1112 


1113 


11174 


1115 


1116 


1117 


1118 


1119 


1120 


1121 


1122 


1123 


1124 


Error Message 


A comma "," cannot follow 
wet. 


"tt cannot be a function 


parameter. 


Expression too complex. 


Invalid (non-ASC11) 
character found. 


Internal error - parser 
stack underflow. 


"!" is an undefined 
variable. 

A name cannot follow "!", 
Invalid logical expression. 
Logical operator cannot 
follow "!". 


Relational operator cannot 
follow "!". 


String cannot follow "!", 


Number of sign (+,-) 
cannot follow "!", 


Unclosed string cannot be 
used. 


Meaning 
Comma is out of syntax context. 


The parameter doesn't follow con- 
ventions for ABS, SQRT, LOG, LN, 
CUMULATE, MOVEAVG. 

The expression has too many oper- 
ators or parentheses. 


Specified non-printable character. 


Software internal error-not under 
user control. 


Variable not defined by GDEFNSET 
OR GTRANSET or Data Definition 
or Transformations Menus. 


Variable or function name out of 
context. 


Software internal error, not under 
user control. 


Logical operator out of context. 
Relational operator out of syntax 
context. 

String is out of syntax context. 


Number or sign is out of syntax 
context. 


Close " or' not found. 





Action 





See section 3 for syntax rules. 


Change parameter to comply with 
function format. 


Reduce number of parentheses or 
define additional variables to 
simplify arithmetic expression. 


Specify printable character. 


See your system manager. 


Define variable. 


Correct expression. See section 3 of 
reference manual. 


See your system manager. 
Change expression to conform to 
syntax rules in section 3. 


See syntax rules in section 3. 


See syntax rules in section 3. 


See syntax rules in section 3. 


Insert " or ' to terminate string. 





Error Message 
ee ee ot 


1125 


1130 


1131 


1132 


1133 


1134 


1135 


1140 


1141 


1142 


1143 


1171 


MOD operator not used 
correctly. 


Missing left parentheses. 


Missing right parentheses. 


Missing comma. 


Logical operator can only 
be applied to logical 


Numerical operator can only 
be applied to numerical 
operands, 


Text operator can only be 
applied to text operands. 


Could not figure out your 
expression the way its 
written. 


Internal error-bad token 
received from scanner. 


Internal error-GENERATE 
found bad operator in 
opstack. 


Internal error-PARSER. 


Internal error-IO buffer 
too small. 


Meaning 
Mod operator out of context. 
Number of right parentheses 


exceeds number of left parentheses. 


Number of left parentheses exceeds 
number of right parentheses. 


Parameters of function call are not 
separated by a comma. 


Logical operator applied to operand 
which cannot be reduced to valid 
relation. NAME=JOE OR SUE. 


Numerical operator applied to a 
string, textual variable, logical 
operand. 


Text operator applied to a non-text 
operand. DIVISION=4. 


Expression syntax not decipherable. 


Internal software error, not under 
user control. 
Internal software error, not under 
user control 
Internal software error, not under 
user control. 
Internal software error, not under 


user control. 
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Action 


Specify Mod operator just like/ 
operator. 

Balance parentheses. 

Balance parentheses. 

Separate parameters by a 

comma, check calling sequence. 
Change operand to a relation, i.e., 


NAME=RICH OR NAME=SUE. 


Change operand to be numeric. 


Change operand to be textual. 


Conform expression to syntax rules 
in section 3 of reference manual. 


Contact your system manager. 


Contact your system manager. 


Contact your system manager. 


Contact your system manager. 


a ee ee 
Error Message 
a a a ee ee 


1172 


1173 


1174 


1175 


1176 


Tit 


1178 


1179 


1180 


1181 


Data file not specified or 


could not be opened. (FSERR! ) 


Record size or fields 
inconsistent with definition 
(FSERR! ) 


Internal error-SDBUILD 
failed (FSERR!) 


Internal error-SDMODIFY 
failed (FSERR!) 


Internal error-FAST'READ 
failed (FSERR!) 


Internal error-FAST'WRITE 
failed (FSERR!) 


Data file contains unusable 
numeric value. 


Data file contains unclosed 
string. 


Internal error-Could not 
prepare SD file for I/O. 


Internal error-SDFILEINFO 
failed. 


Meaning 


Data file doesn't exist or for some 
other reason could not be opened. 


Internal software error, not under 
user control. 


File space not available for data 
manipulation. 


File space not available for data 
manipulation. 
Input/output failure. 


Input/output failure. 


Data file contains a non-numeric 


Value. 


Data contains a string with only 1 
quotation mark around it. 


Internal error accessing the data 
file; not under user control. 


Internal error accessing the data 
file; not under user control. 


Action 


Refer to the file system error 
number for more information and 
possible action. 


Data file definition specified in 
GDEFNSET does not match actual data 
file. 


Refer to the file system error 
number for more information and 
possible action. 


Refer to the file system number for 
more information and possible 
action 


Refer to the file system number for 
more information and possible 
action. 


Refer to the file system number for 
more information and possible 
action. 


Correct value to be: digits, with 
optional signs, exponents and "." 

in the correct order. Remove any 
non-displayable control characters; 
these may be found by looking at the 
file with the display functions 
option of the terminal active. 


Close the quotes in the data file. 


Contact your system manager. 


Contact your system manager. 


Error Message 


1182 


1183 


1184 


1185 


1186 


1187 


1195 


1197 


1200 


1201 


1202 


1203 


Meaning 


Internal error-SDGETALLOCDESC Internal error accessing the data 


failed. 


Internal error~SLOW'WRITE 


failed. 


Internal error-FCLOSE failed. 


Internal error-FOPEN failed. 


Internal error-FGETINFO 


failed. 


Internal error-FPOINT failed. 


Internal error-parser 
failed(!). 


Internal error-MPESORT 
failed. 


<,>,=,22,<=, ore has 
operands of inconsistent 
types. 


Logical operator (AND,OR, 
or NOT) used incorrectly. 


Internal error-LOG'EXEC 
failed an internal check. 


Transformation expression 
has an undefined variable. 


file; not under user control. 


Internal error accessing the data 
file; not under user control. 


Internal error accessing the data 
file; not under user control. 


Internal error accessing the data 
file; not under user control. 


Internal error accessing the data 
file; not under user control. 


Internal error accessing the data 
file; not under user control. 


Internal software error, not under 
user control. 


Internal software error, not under 
user control. 


The variables on either side of the 
operand are not of the same type. 


A logical operator was used 
incorrectly. 


Internal error not under user 
control. 
Transformation expression contains 


a variable which was not previously 
defined. 
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Action 





Contact your system manager. 


Contact your system manager. 


Contact your system manager. 


Contact your system manager. 


Contact your system manager. 


Contact your system manager. 


Contact your system manager. 


Contact your system manager. 


Change the variables used so 
that either both sides are 
numerical or both sides are 
textual. 


Make sure the logical operators 
AND and OR have 2 operands and the 
logical operator NOT has 1 operand. 


Contact your system manager. 
Change variable to a name pre- 


viously defined or define 
variable. 


Error Message 


1204 File subset expression or 
or qualification has an 
undefined variable. 


1205 Pie explosion expression 
has an undefined variable. 


1206 The independent (or X axis) 
variable is not defined. 


1207 Label variable is not 
defined. 


1208 Line or bar Y axis 
variable is undefined. 


Meaning 


Subset expression contains a vari- 
able name which hasn't been pre- 
viously defined. 


Pie explosion expression contains a 
variable name not previously defined. 


The independent variable for the 
chart hasn't been previously defined. 


The label variable for the pie 
chart hasn't been previously 
defined. 


The dependent variable hasn't been 
previously defined. 


ARITHMETIC EXPRESSION RUN TIME ERRORS 


1220 Invalid type used in 
transformation expression. 


1221 Special functions not 
implemented yet. 


1222 Internal error-arithmetic 
result not at top of stack. 


1223 Moving average over too many 
values. Make n smaller. 


1224 Moving average specifies 
undefined variable. 


1225 First parameter of MOVE- 
AVG must be a variable 


1226 Second parameter of MOVE- 
AVG must be a positive 


A textual variable was specified in 
transformation expression. 


Certain function may be implemented 
in future release. 


Internal software error, not under 
user control. 


For MOVEAVG (var,n); n is too large. 
For MOVEAVG (var,n); var is not a 
defined variable. 


The first parameter for the moveavg 
function is not a variable name. 


The second parameter for the moveavg 
function is not a positive integer. 





Action 





Define variable name. 


Define variable name. 


Define varible name. 


Define variable name. 


Define variable name. 


Redefine variable type to be num- 
eric or remove variable from 
expression. 


Don't use non-implemented 
special functions. 


Contact your system manager. 
Make n smaller. 

Define var. 

Specify a variable name as first 


parameter. 


Specify a positive integer as second 
parameter. 


a ee en ln 
Error Message 


a i 


1227 


The parameter for CUMULATE 
must be a variable name. 


PASCAL SUPPORT ERRORS 


1300 


1301 


1302 


FILE 
1401 


1402 


1403 


1404 


1405 


1406 


1407 


1408 


The PASCAL stack allocation 
routine (GETHEAP) is 
missing. 


The PASCAL stack dealloca- 
tion routine (RTNHEAP) is 
missing. 


The stack space could not be 
expanded for the GRAF area. 


NAME LEGALITY ERRORS 


The filename length is 
incorrect. 


Filename can't be all 
blanks. 


Backword references can't 
contain lockwords. 


Backword references can't 
contain group names. 


Backword references can't 
contain account names. 


Filename must begin with a 
letter. 


Lockword must begin with a 
letter. 


Group name must begin with 
a letter. 


The parameter for the cumulate 
function is not a variable name. 


The system library does not contain 


the necessary PASCAL routine 
GETHEAP. 


Action 


Specify a variable name as cumulate 
parameter. 


Update system library to include 
the routine GETHEAP. 


The system library does not contain Update the system library to include 
the necessary PASCAL routing RTNHEAP.the routine RTNHEAP. 


DSG/3000 can't allocate required 


stack space. 


Illegal file name. 


Illegal file name. 
Illegal file name. 
Illegal file name. 
Illegal file name. 
Illegal file name. 
Illegal filename. 


Illegai filename. 


C-38 


Reduce user program stack space. 


Refer 


Refer 


Refer 


Refer 


Refer 


Refer 


Refer 


Refer 


to 


to 


to 


to 


to 


MPE 


MPE 


MPE 


MPE 


MPE 


MPE 


MPE 


MPE 


naming conventions. 


naming conventions. 


naming conventions. 


naming conventions. 


naming conventions. 


naming conventions. 


naming conventions. 


namining conventions. 








Error Message Meaning Action 

1409 Account name must begin with Illegal filename. Refer to MPE naming conventions. 
a letter. 

1410 Filename must contain 8 Illegal filename. Refer to MPE naming conventions. 
characters or less. 

1411 Lockword must contain 8 Illegal filename. Refer to MPE naming conventions. 
characters or less. 

1412 Group name must contain 8 Illegal filename. Refer to MPE naming conventions. 
characters or less. 

1413 Account name must contain 8 Illegal filename. Refer to MPE naming conventions. 
characters or less. 

1414 Filename can't contain Illegal filename. Refer to MPE naming conventions. 
embedded blanks. 

1415 Lockword can't contain Illegal filename. Refer to MPE naming conventions. 
embedded blanks. 

1416 Group name can't contain Illegal filename. Refer to MPE naming conventions. 
embedded blanks. 

1417 Account name can't contain Illegal filename Refer to MPE naming conventions. 
embedded blanks. 

1418 Filename must contain only Illegal filename. Refer to MPE naming conventions. 
letters and numbers. 

1419 Lockword must contain only Illegal filename. Refer to MPE naming conventions. 
letters and numbers. 

1420 Group name must contain only Illegal filename. Refer to MPE naming conventions. 
letters and numbers. 

1421 Account name must contain Illegal filename. Refer to MPE naming conventions. 
only letters and numbers. 

1422 Expected a backword ref- Illegal filename. Refer to MPE naming conventions. 


erence but didn't find one. 


Error Message 


1423 Expected a lockword but 
didn't find one. 


1424 Expected a group name but 
didn't find one. 


1425 Expected an account name but 
didn't find one. 


1426 One lockword can be included 
following the filename. 


1427 Only two periods are allowed 
in a filename. 


1428 Filename can't be longer 
than 35 characters. 


1429 '$' may not be used here. 
FIGURE FILE ERRORS 


1440 Figure name is illegal. 


1441 Figure ! already exists 
in the figure file. 


1442 Figure file! does not 
exist. 


1443 Figure ! does not exist 
in the figure file. 


1444 Figure ! is currently in 
use and cannot be deleted. 


1450 AGL GBEGINFIG failed for 
figure !. 


Illegal filename. 


Illegal filename. 
Illegal filename. 


Illegal filename. 


Illegal filename. 


Illegal filename. 


Illegal filename. 


Specified figure name does not 
follow MPE naming conventions. 


Figure already exists with the 
same name. 


User cannot access a non-existent 
figure file. 


User cannot access a non-existent 
figure. 


Figure is currently being accessed 
by another user. 


Software internal error-not under 
user control. 


c-ho 


eee 


Action 


eee 


Refer to MPE naming conventions. 


Refer to MPE naming conventions. 


Refer to MPE naming conventions. 


Refer to MPE naming conventions. 


Refer to MPE naming conventions. 


Refer to MPE naming conventions. 


Refer to MPE naming conventions. 


Refer to MPE naming conventions. 
Use a unique figure name. 
Change the name to an existing 


figure file. 


Do not try to access a non-existent 
figure. 


Must wait until figure is released 
by other user. 


See your system manager. 


Error Message 


1451 AGL GENDFIG failed for 
figure !. 


1452 AGL GDELETEFIG failed for 
figure !. 


1453 Figure file ! is currently 
in use and cannot be opened. 


1454 File ! exists but is not a 
figure file. 


Meaning 


Software internal error-~not under 
user control 


Software internal error-not under 
user control. 


Figure file is being accessed by 
another user. 


A figure file can not be created 
with the same name as an already 


LOCALIZATION MESSAGES USED BY INTRINSICS ONLY 


4000 The message file 
(CO1C250A. PUB.SYS.) cannot 
be accessed. 


4001 The requested message is 
not in the message file. 


4020 Internal device tables 
don't match; new version 
required. 


4021 Internal device table is 
bad; need new message 
catalog. 


GRAPH PROGRAM ERRORS 


5000 Color must be a positive 
integer (1-16) 


5001 Size must be a positive 
integer (1-50) 


5002 Font must be a positive 
integer (1-4). 


The message file is not available 
in PUB.SYS. 


Software internal error-not under 
user control. 
Software internal error-not under 


user control. 


Software internal error-not under 
user control. 


User specified a non-positive 
integer for color. 


User specified a non-positive 
for size. 


User specified a non-positive 
integer for font. 
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A R 


Action 


i 


See your system manager. 


See your system manager. 


Must wait until other user 
releases the figure file. 


Change the name of the figure 
file. 


Restore error message file in PUB. 
SYS as shown in installation 
instructions. Contact system mgr. 


Verify that correct DSG/3000 
version was installed. 


Verify that correct DSG/3000 


version was installed. 


Verify that correct DSG/3000 
version was installed, 


Specify color as a positive integer 


Specify size as a positive 
integer (1-50) 


Specify font as a positive 
integer (1-4). 


Error Message 


5003 


5004 


5005 


5006 
5007 


5008 
5009 


5010 


CONVE 


15015 


15016 


15020 


15021 


15022 


GENMESSAGE ERROR in 
GET ' COMMAND. 


GENMESSAGE ERROR in 
IS'GENERIC. 


GENMESSAGE ERROR in 
GET 'GENERIC. 


No figure name specified. 


No figure file specified. 


No chart name specified. 


No chart file specified. 


Please enter "A" or "D", 


RSION ERRORS 


Error occurred converting 
chart!. 


The chart file is newer 
than the code; update 
DSG/3000. 


Error occurred when purg- 
ing file ! (CIERR!) 


INTERNAL ERROR: Chart file 
record longer than buffer. 


Failed to create convert 
file!. (FSERR!) 


Meaning 


Software internal error-not 
under user control. 


Software internal error-not 
under user control. 


Software internal error-not 
under user control. 


Figure name must not be all blanks. 


Figure file name must not be all 
blanks. 


Chart name must not be all blanks. 


Chart file name must not be all 
blanks. 


Add and delete are the only valid 
commands. 


Chart was not converted to new 
format. 


A chart file from a system with 
more recent version of DSG/3000 
is being accessed by an older 
version of DSG/3000. 

File was not purged. 

Software internal error - not 


under user control. 


File system error occurred when 
trying to convert file. 
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Action 





Verify that correct DSG/3000 version 
was installed. 


Verify that correct DSG/3000 version 
was installed. 


Verify that correct DSG/3000 version 
was installed. 


Supply a valid figure name. 


Supply a valid figure file name. 


Supply a valid chart name. 


Supply valid chart file name. 


Specify "A" for add or "D" for 
delete. 


See your system managert. 


Install the new version on your 
system. 


Verify status of file to be purged. 


See your system manager. 


Refer to FSERR! 


Error Message 


15023 READ failed on file! 
(FSERR! ) 


15024 WRITE failed on file!. 
(FSERR! ) 


15025 Failed to close file!. 
(FSERR! ) 


15026 A name for the convert 
file name cannot be all 
blanks. 


15027 Failed to open file! 
(FSERR! ) 


15029 Chart file name and 
convert chart name 
cannot be the same. 


WARNING MESSAGES 
GCOMMENTINQ 


- 95 WARNING: User's buffer too 
small to receive comments 
for chart. 


GPIEINQ 


~134 WARNING: User's buffer is 
too small to receive all 
colors. 


-135 WARNING: User's buffer is 
too small to receive all 
textures. 


Meaning 
File system error occurred when 
trying to convert file 


File system error occurred when 
trying to convert file. 


File system error occurred when 
trying to convert file. 


Convert file name cannot be all 
blanks. 


File system error occurred when 
when tring to convert file. 


Commentsbuf parameter is not large 
enough to receive comments for the 


chart. 


Colorbuf is not large enough to 


receive all color specifications. 


Textbuf is not large enough to re- 
ceive all textures. 


errr 


Action 


A 


Refer to FSERR! 
Refer to FSERR! 
Refer to FSERR! 


Refer to MPE naming 
conventions. 


Refer to FSERR! 


Make commentsbuf larger and set 
commentsbuflen accordingly. 


Make colorbuf larger, and set color- 
buflen accordingly. 


Make texturebuf larger, and set 
texturebuflen accordingly. 


eee 


Error Message 


Action 


aS a ee 


GTITLEINQ 


-163 WARNING: User's buffer too 
small to receive complete 
title. 


~164 WARNING: User's buffer too 
small to receive complete 
subtitle. 


~165 WARNING: User's buffer too 
small to receive complete 
footnote. 


-166 WARNING: User's buffer too 
small to receive second 
footnote. 


-167 WARNING: User's buffer too 
small to receive right axis 
title. 

~168 WARNING: User's buffer too 
small to receive X axis 
title. 


-169 WARNING: User's buffer too 
small to receive Y axis 
title. 


GAXISSET 
-196 WARNING: Incompatible 


minimum, maximum, or 
interval size. 


Titlebuf is not large enough to 
receive entire title. 


Same as number 163. 


Same as number 163. 


Same as number 163. 


Same as number 163. 


Same as number 163. 


Same as number 163. 


The specified (or default if 

none is specified) values for 

for the minimum, maximum, and 
interval size do not fit evenly 
together. For example, the specified 
minimum and interval size may extend 
beyond the maximum. 


Make titlebuf larger, and set 


titlebuflen accordingly. 


Same as number 163. 


Same a number 163. 


Same as number 163. 


Same as number 163. 


Same as number 163. 


Same as nmber 163. 


Change one or more of the scaling 
variables so that (minimum-max imum) 
/interval size) is an integer value. 


Error Message 


GLABELINQ 


-242 


WARNING: User's buffer too 


short to receive all labels. 


GTEXTINQ 


-271 


WARNING: User's buffer too 
short to receive annotation 
text. 


GEXECHART 


414 


-463 


464 


465 


~466 


“491 


493 


WARNING: AGL GPENSPEED 
failed for chart!. 


WARNING: Too many intervals 
(!) for a readable chart. 


WARNING:No chart has been 
defined. 


WARNING: Bar interval size 
too small for a readable 
chart. 


WARNING: Bars drawn only 
for the first 31 intervals. 


WARNING: Chosen language 
is not available for font! 
in chart! 


WARNING: Best fit font used 
for font! in Chart! 


Meaning 


Labelbuf is not large enough to 
receive all labels. 


Textbuf is not large enough to re- 
ceive all annotation text. 


An internal error message. 


Tick marks are too close together. 


Interval size is so small that 
bars will be drawn too close 
together to be very clear. 


Data for more than 31 bars is 
present, but only the first 31 
bars, or clusters of bars, can 
be drawn. 


Specified language is not accessible 
for user font. 


Font file is not accessible for 
user device. The best fit (stick) 
font was used instead. 





Action 





Make labelbuf larger and set 
labelbuflen accordingly. 


Make textbuf larger and set 
textbuflen accordingly. 


Contact your system manager. 


Increase interval size. 


Set the interval size to a larger 
value. 


Split the data over multiple charts, 
or reduce the number of bars to be 
drawn using data subsetting. 


Change the language or use a font 
file which includes the speciied 
language. 


Verify status of the named file; 
use the name of a valid font file. 


a eee 


Error Message 


Action 


a a et ee ee 


-~495 WARNING: File! in chart! is 
not a font file. Best fit 
used. 


MISSING DATA 


-577 WARNING: Missing data values 
were not plotted for chart!. 


LOG SCALING 
-600 WARNING: Negative or 0 data 


on chart! treated as 
missing. 


Font file is not accessible for 
user device. The best fit (stick) 
font was used instead. 


Missing data values were not used 
when plotting data. 


The data associated with the indi- 
cated chart contained non-positive 
data which does not have a legal 
logarithm. This data was treated 
as missing data is treated. 


GDATAFILEINQ, GDEFNINQ, GTRANINQ, GSUBINQ, GDEPVARING 


-800 WARNING: User's buffer too 
small to receive missing 
data value. 


-801 WARNING: User's buffer is 
too small to receive 
variable names. 


-802 WARNING: User's buffer is 
too small to receive 
variable definitions. 


-803 WARNING: User's buffer is 
too small to receive 
transformations. 


-804 WARNING: User's buffer is 
too small to receive sub- 
set or explosion. 


Missbuf is too small to receive the 
missing data value. 


Varbuf is too smail to receive the 
variable names. 





Varbuf is too small to receive the 
varlable definitions. 


Exprbuf is too small to receive 
transformation expressions. 


Subsetbuf is too small to receive 


subset expressions. 


Verify status of the named file; 
use the name of a valid font file. 


None. 


If you are aware the data is 
negative or 0, ignore this 
message. Otherwise, change the 
data. 


Make missbuf larger and set miss- 
buflen accordingly. 


Make varbuf larger and set varbuflen 
accordingly. 


Make varbuf larger and set varbuflen 


accordingly. 


Make exprbuf larger and set 
exprbuflen accordingly. 


Make subsetbuf larger and set 
subsetbuflen accordingly. 


Error Message 


~805 WARNING: User's buffer is 
too small to receive 
qualifications. 


SD'TRANS 
-865 WARNING: Divide by zero 


occurred during trans- 
formations. 


~866 WARNING: Floating point 
overflow during trans- 
formations. 


GLABVARSET 


-885 WARNING: "!" is not a 
textual variable. 


VARTABLE SEMANTIC ERRORS 


-1003 WARNING: "!" is not 
defined. 
-1004 WARNING: "!" is a 


textual variable. 


PASCAL STACK/SUPPORT WARNINGS 


-1310 WARNING: Extended stack 


Space was not deallocated. 


Meaning 


Qualbuf is too small to receive 
the qualification expressions. 


Divide by zero occurred during 
transformations. The result and 
subsequent manipulations will be 
given the missing data value. 


Floating point overflow occurred 
during transformations. The result 
and all subsequent manipulations 
will be given the missing data 
value. 


The label variable specified is a 
numeric variable. 


The specified variable has not 
been defined. 


The specified variable is a text- 


ual variable. 


User is trying to terminate without 
without deallocating stack space. 





Action 





Make qualbuf larger and set 
qualbuflen accordingly. 


Either accept the missing data value 
result, or change the transformation 
or data so the divide by zero does 
not occur. 


Either accept the missing data value 
results, or change the trans- 
formation or data so the floating 
point overflow does not occur. 


Change the label variable to a 
textual variable. 


Define the specified variable or 
use a variable which has been pre~ 
viously defined. 


Change the variable type to numeric 
or specify an existing numeric 
variable. 


Deallocate stack space. Otherwise 
the space will be deallocated when 
the program terminates. 


eee 


Error Message Meaning Action 
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FIGURE FILE WARNINGS 


-1445 WARNING: Figure ! could Figure does not exit in figure file. Check the figure name and figure 
not be found. file name. 


C-48 


MAXIMUM LIMITS 


| 
| 
| 
beg 


Chart file name 
Data file name 


Chart name 
Variable name 


Number of charts/ 
chart file 


Number of defined 
variables/chart 


Length of chart 
comments 


Length of qualifi- 
cation expression 


Number of quali- 
fications/chart 


Length of subset 
expression 


Number of subsets/ 
chart 


Length of transfor- 
mation expression 


Interactively 


35 characters (fully 
qualified file name 
including lockword) 


35 characters (fully 
qualified file name 
including lockword) 


16 characters 
16 characters 


50 


45 characters 
106 bytes per 
qualification 


8 


72 characters 


57 characters 





Programmatically 
35 characters (fully 
qualified file name 
including lockword) 
35 characters (fully 
qualified file name 
including lockword) 
16 characters 


16 characters 


50 


No fixed limit 


860 bytes for the 
entire chart 

8 
200 characters for 


the entire chart 


1 


57 characters 























Interactively 


Number of trans- 
formed variables/ 
data file 

Length of explo- 72 characters 
sion expression 


Maximum data 
record length 


512 bytes 


Maximum data 1.0E77 


value 


Minimum data 1.0E-77 


value 
Number of line 
types 
Number of textures 
Number of colors 


BAR AND LINE CHARTS 


Number of vertical 
axis variables 

Length of main 45 characters 
title 


64 characters 


Length of subtitle 





Programmatically 





10 


No fixed limit 


512 bytes 


45 characters 


64 characters 


BAR AND LINE CHARTS (Continued) 


interactively 


Programmatically 





Left vertical axis | 78 characters 90 characters 


title 


Horizontal axis 78 characters 90 characters 


title 
90 characters 


Footnote 78 characters 


Length of labels | 25 characters 25 characters 


Number of labels 16 650 characters max. 


2 lines of 18 
characters each 


2 lines of 18 
characters each 


Legend text 


Maximum anno- 20 20 
tations per chart 





Number of bars 60 60 
Number of 8 
legends 
PAPER SIZES 


A4 210x 297mm 
A3 280 x 420mm 


A 8.5 x 11 inches 
B 11 x 17 inches 
CG 17 x 22 inches 
D 22 x 34 inches 
E 34 x 44 inches 


PIE CHARTS 





Number of pie 
segments 


Main title 


Subtitle 


Footnote 


Length of labels 


Interactively 


30 







45 characters 


64 characters 






2 lines of 78 
characters each 










25 characters 






30 


45 characters 


64 characters 


2 lines of 90 


characters each 


25 characters 


Programmatically 


The purpose of figure files is discussed 
in Section I of this manual. The precise 
manner in which figures and figure files 
are created interactively is described 
in Sections 4 and 5, where the appro- 
priate menus are covered. Programmatic 
creation is discussed in Sections 6 and 


t. 


Figure files have several functions, the 
foremost among them being that they pro- 
vide storage for a complete chart -- 
data file and chart design -which is 
then accessible by other subsystems, 
such as HPDRAW and HP2680A (the Laser 
printing system). Below is a general 
description of the way in which the fi- 
gure files are accessed by the HP2680A. 


Using Figure Files 
With the HP 2680A 


The HP2680A (Laser printer) may be used 
as a direct output device for plotting a 
chart. You enter the identifying number 
on the Graphing Options Menu if you are 
working interactively, or the GDEVICESET 
procedure if you are working program- 
matically. 


You will also have occasion to use 
charts previously prepared and stored in 
a figure file. These you may wish to 
merge with text, to be printed by the 
HP2680A. To accomplish this you would 
use an element of the Interactive For- 
matting System, IFS/3000, specifically 
developed for the Laser printing system. 


IFS2680 allows you to call the figure 
file and define the format of documents 
to be printed by the Laser system. The 
procedures required for programmatic use 
are described in Section 5 of the 
IFS2680 Reference Guide. If you in- 
tend to perform these tasks non-program- 
matically, you would use the LPS Inter- 
preter. 


The LPS Interpreter sends environment 
files and text files to the HP2680A and 
executes formatting commands by calling 
the IFS/3000 programmatic intrinsics. 
Using the interpreter does not require 
knowledge of a programming language. 

Its use is discussed in Section 4 of the 
IFS2680 Reference Guide. 


Use With Other 
Subsystems 


Figures and figure files are also avail- 
able to users of HPDRAW, HPEASYCHART and 
TDP/3000. Charts made using HPEASYCHART 
cannot be enhanced except through the 
use of DSG/3000. 


See the appropriate manuals for informa- 
tion concerning the way figure files may 
be accessed by the various subsystems. 


A brief example of the way figure files 
are used with TDP/3000 follows on the 
next page. 


An excerpt from a report written in TDP/3000 is reproduced below. Explanations 
the commands appear in italics on the right. The results of this portion of the 
program is shown on the next page. 


1 
2 
2 


33 
34 
2) 
36 
37 
3D 
36 
of, 
38 
39 
4O 
Ta 
42 
43 
4h 
45 
46 
47 
48 


\envir bzenv name of environment file 
\Tft Ss 7ht.. 70 sets right and left margins 
\fontid 11 tdentifies font to be used 


from environment 


\new begins new page 

\font 11 font 1 specified for use for line 1 
\center 1 item (the title) to be centered 
MISCELLANEOUS title 


As usual, during the course of our study, we found that 
there were some businesses which did not fit in any of 
the same gneral categories as the others. Not knowing 
what else to call these, we created a miscellaneous class 
of businesses. These are shown in the following chart. 
\name raster rastil indicates illustration command follows 
\illustration figfile:fig 24,C convert figfile to a raster 
and save it under the name rastl11. 
Then center the figure on the page. 
It will take up 24 spaces. 


Bed 


MISCELLANEOUS 


As usual, during the course of our study, we found that there were 
some business which did not fit in any of the same general 
categories as the others. Not knowing what else to call these, we 
created a miscellaneous class of businesses. These are shown in 
the following chart. 


MISCELLANEOUS SMALL BUSINESSES 


1981 Survey 
TAILORING 
18.4 % 







FURNITURE 


INTERIOR DES 
20.4 % 







HOUSE PAINT 
‘se 20.4 % 
me deb 
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Files created using an earlier version 
of DSG/3000 will need to be updated for 
use with the present version. These 
would be the versions designated 
A.00.00, A.00.01, and A.00.02. Files 
need be converted only once. Two means 
of updating files are provided. One is 
an interactive method. To use it, type 
the following: 


:>RUN GUPDATE.PUB.SYS 


A banner will appear on the screen, fol- 
low by the following instructions: 


Enter name of chart file to be 
converted (return to EXIT): 


You will enter the old file name after 
the colon and the following instruction 
will appear: 


Enter an unique name for the converted 
file to be created: 


When you enter the two names following 
the colons, you will receive the fol- 
lowing messages: 


Chart file oldfilename was converted 
successfully. The converted file 
newfilename should now be used with 
DSG/3000. 


You can continue to enter names of chart 
files to be converted if you wish. The 
first instruction will be repeated: 


Enter the name of the chart file to be 
converted: 


Press carriage return to exit. 


Note that oldfilename and newfilename 
cannot be the same. This protects the 
old file in case of system failure. 


newfilename must not already exist as 
another file. 


oldfilename and newfilename must 
follow MPE file naming conventions 
(may have lockword). 


A procedure was developed to convert 
files programmatically. It is descibed 
on the next page. 


GCONVERTFILE 


Converts the contents of a chart file for use with the current 
version of DSG/3000. 


PARAMETERS 


graf Integer array containing global information used 
by DSG/3000. The first word returns the call 
status. 


chartfile Byte array holding name of the old copy of the 
chart file to be converted. Must be 36 alpha- 
numeric characters (including lockword, group, 
and account) beginning with an alphanumeric 
character. 


convertfile Byte array holding the name of the converted 
version of the chart file. This name must 36 
alphanumeric characters (including lockword, 
group, and account) beginning with an alpha- 
numeric character. The file must not exist 
prior to this call. 


DISCUSSION 


GCONVERTFILE converts the format of the chart file for use by the new 
version of DSG/3000. The old chart file is unchanged. The new ver- 
sion is stored in the specified file. 


If an error occurs, the converted file may be usable for some charts 
and other charts may need to be deleted or rebuilt. If the error is 
such that the entire file is unusable, the chart file will need to be 
completely rebuilt using the new version of DSG/3000. 


B=2 


Plotters and Graphics Terminals 


On the following pages are some of the plotters and 
graphics terminals supported by HPDRAW. 


Included for each piece of equipment is how to turn it 
off and on, and how to load pens and paper for plotters. 
Also included is how to change address codes for 
HP-IB devices. 


HP-IB and Address Codes 

Some plotters are ronnected to the HP2647 and 
HP2648 graphics terminals with an HP-IB cable. Each 
piece of equipment connected to theseterminals has a 
unique address code that allows the terminal to 
recognize responses from that piece of equipment. 


HPDRAW recognizes a default address code of 5. If 
your plotter is not set to 5 you can change the plotter 
address code, or if you know the address code for the 
plotter, you can enter the number in the HP-IB field on 
the Plotting menu. The HP-IB field only appears for 
Regular and Expert users when the Details key is 
pressed. 


You can have more than one kind of plotter attached to 
the terminal. In this instance, each plotter should have a 
unique address code. When you want to use a certain 

plotter, you can enter the plotter’s address code in the 

HP-I|B field. 


G-1 


RS-232-C Connectors 


Two types of connectors are available for different 
terminals: HP-IB and RS-232-C. RS-232-C Connectors 
are connected to your terminal and do not require 
HP-IB addresses to be entered. If you have any 
problems with connectors, see your System Manager. 


Plotter Pen Types 


Three types of plotter pens are available: fiber tip (2 
kinds), roller ball, and drafting. The roller ball and 
drafting pens are used only for the HP7580A and 
HP7585A Drafting plotters. 


Fiber tip pens are used for all plotters. They are marked 
with a color matching the pen’s ink and a two-character 
code. 


The first character tells the kind of pen: P is for paper, T 
is for transparency. The second character gives the 
width of the pen tip in millimeters. For example, P3 is a 
pen for paper with a 0.3 millimeter tip. 


7220 A, C, S, T Plotter 
HP7220 Front and Rear Views 

















Paper 
Advance 
Thumbwheel 


Paper 
Stop 


Left Door 


Latch : 


Pen Holder 


Right Door 
Latch 


Plotter 
Arm 


Platen 


Paper 
Stop 


id On/Off 


Switch 


Enter 


Button Pen Stall Buttons 


Figure 3-1. Two Front Views 7220C and 7220T 
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HP-IB 
Connection 


Figure 3-2. Rear View 


Power ON/OFF 
The on/off switch is located on the lower right front of 
the plotter. 


a 


Press the button in to turn the power on. Pressing the 


button a second time turns the power off. 


When the switch is on, the pen holder on the plotter 


arm moves to the lower right corner. 
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Loading Pens 


qs 


2) 


Select a pen and remove its cap. 


Place the tip of the pen into the rubber cap at the 
bottom of the stall you want to use. Push the pen in 
gently until it snaps into place. Repeat this proce- 
dure for any other pen stall. 


To remove pen from the stall, press down on lever to 
the right of the pen. Grasp the pen firmly between 
thumb and forefinger and pull gently out of the pen 
Stall. 


Loading Paper (7220T Four Pen) 


1. 


Set the on/off switch to off. Remove pen from the pen 
holder so ink does not get on your paper. 


. Press down on the paper stop on the left side of the 


platen. Open both the left and the right paper supply 
modules by pressing the door latch buttons. 


Position roll paper between hubs in right supply 
module and align hub tabs with roll notches. Paper 
should feed across top of roll. 


Place paper sprocket holes on sprockets at end of 
roller. Hold paper while closing door. Make sure 
paper is not on top of paper guide at front edge of 
platen. 


. Advance paper with thumbwheel until taut. 


. Turn plotter switch to on and press ADV HALF button 


to advance the paper half a page. 
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Loading Paper (7220C) 

1. Set the on/off switch to on. Raise the paper stop on 
left side of the platen by pushing the upper portion of 
the stop with a pencil or pointed object. 


2. Press the Chart Load button. The Chart Load and 


Out of Limit lights should go on and the plotter arm 
and pen holder is moved to the upper right corner of 
the platen. 


3. Place a sheet of paper on platen with bottom under 
plastic lip and left side against the paper stop. Press 
Chart Hold push button. The Chart Load light should 
go out and Out of Limit light stays on. Smooth paper 
down using the back of your hand. 


For more information on the 7220C/T plotter, refer to the 
Graphics Plotter Operating and Programming Manual, 
P/N 07220-90053. 


7221A, B, S Plotter 
HP7221 Front and Rear Views 
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Figure 3-3. Two Front Views 7221C and 7221T 
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HP-IB 
Connection 


Figure 3-4. Rear View 


Power ON/OFF 
The on/off switch is located on the lower right front of 
the plotter. 


1. 


Press the button in to turn the power on. Pressing the 
button a second time turns the power off. 


When the switch is on, the following occurs: the On 
Line light and the Out of Limit light are now on and 
the fan motor starts running. 


Loading Pens 


ue 


oe 
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Select a pen and remove its Cap. 


Place the tip of the pen into the rubber cap at the 
bottom of the stall you want to use. Push the pen in 
gently until it snaps into place. Repeat this proce- 
dure for any other pen stall. 


. To remove pen from the stall, press down on lever to 


the right of the pen. Grasp the pen firmly between 
thumb and forefinger and pull gently out of the pen 
stall. 


Loading Paper (7221S) 


1. 


Set the on/off switch to off. Remove pen from the pen 
holder so ink does not get on your paper. 


Press down on the paper stop on the left side of the 
platen. Open both left and right paper supply 
modules by pressing the door latch buttons. 


. Position roll paper between hubs in right supply 


module and align hub tabs with roll notches. Paper 
should feed across top of roll. 


. Place paper sprocket holes on sprockets at end of 


roller. Hold paper while closing door. Make sure 
paper is not on top of paper guide at front edge of 
platen. 


. Advance paper with thumbwheels until taut. 


. Turn plotter switch to on, and press ADV HALF but- 


ton to advance the paper half a page. 
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Loading Paper (7221A, B) 


hy 


Set the on/off switch to on. Raise the paper stop on 
left side of the platen by pushing the upper portion of 
the stop with a pencil or pointed object. 


. Press the Chart Load button. The Chart Load and 


Out of Limit lights should go on and the plotter arm 
and pen holder is moved to the upper right corner of 
the platen. 


. Place a sheet of paper on platen with bottom under 


plastic lip and left side against the paper stop. Press 
Chart Hold push button. The Chart Load light should 
go out and Out of Limit light stays on. Smooth paper 
down using back of your hand. 


For more information on the 7221A, B, S plotter, refer to 
the Graphics Plotter Operating and Programming 
Manual, P/N 07221-90014. 


7221C, T Plotter 
HP7221 Front and Rear Views 
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Figure 3-5. Two Front Views 7221C and 7221T 
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HP-IB 
Connection 


Figure 3-6. Rear View 7221 


Power ON/OFF Loading Pens 
The on/off switch is located on the lower right front of 1. Select a pen and remove its cap. 


the plotter. 
2. Place the tip of the pen into the rubber cap at the 


1. Press the button in to turn the power on. Pressing the bottom of the stall you want to use. Push the pen in 
button a second time turns the power off. gently until it snaps into place. Repeat this 
procedure for any other pen stalls. 


2. When the switch is on, the following will occur: the 
On Line light and the Out of Limit light are now on 3. To remove pen from the stall, oress down on lever to 


and the fan motor starts running. the right of the pen. Grasp the pen firmly between 
your thumb and forefinger and pull gently out of the 
pen stall. 
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Loading Paper (7221T) 


1. 


Set the on/off switch to off. Remove pen from the pen 
holder so ink does not get on your paper. 


Press down on the paper stop on the left side of the 
platen. Open both left and right paper supply 
modules by pressing the door latch buttons. 


Position roll paper between the hubs in right supply 
module and align hub tabs with roll notches. Paper 
should feed across the top of roll. 


Place paper sprocket holes on sprockets at end of 
roller. Hold paper while closing door. Make sure 
paper is not on top of paper guide at front edge of 
platen 


. Advance paper with thumbwheel until taut. 


Turn plotter switch to on, and press ADV HALF but- 
ton to advance the paper half a page. 


Loading Paper (7221C) 


1 


Set the on/off switch to on. Raise the paper stop on 
left side of the platen by pushing the upper portion of 
the stop with a pencil or pointed object. 


Press the Chart Load button. The Chart Load and 
Out of Limit lights should go on and the plotter arm 
and pen holder is moved to the upper right corner of 
the platen. 


Place a sheet of paper on platen with bottom under 
plastic lip and left side against the paper stop. Press 
Chart Hold push button. The Chart Load light should 
go out and Out of Limit light stays on. Smooth paper 
down using back of your hand. 


For more information on the 7221C/T plotter, refer to the 
Graphics Plotter Operating and Programming Manual, 
P/N 07221-90024. 
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7225A, B Plotter 
(17604A Personality Module) 


HP7225 Front and Rear Views 


Pen Holder 
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Figure 3-7. Front View 
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RS-232-C 
Connector 


Figure 3-8. Rear View 
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Power ON/OFF 
The on/off switch is located on the lower right side 
towards the rear of the plotter. 


1. 


Press the button in to turn the plotter on. Pressing the 
button again turns the power off. 


When the switch is on, the pen holder on the plotter 
arm moves to the upper right corner and Chart Hold 
is activated. 


Loading Pens 
1. Select a pen and remove the cap. 


2. When the plotter arm has stopped moving, hold the 


metal carrier ring up with one hand while pressing 
the pen into the holder with the other hand. 


Loading Paper 


1. 


2. 


Press the Chart Load button. This releases the paper 
hold-down mechanism and moves the plotter arm to 
the upper right corner of the platen. 


Position the paper squarely against the ridge at the 
bottom on the platen. Smooth out the paper with the 
back of your hand to avoid smearing the natural oil 
from your fingertips on the paper. 


Press the Chart Hold button to activate the paper 
hold-down mechanism. 


For more information on the 7225A, B Graphics Plotter 
and 17604A Personality Module refer to the Operating 
and Programming Manual, P/N 17604-90000. 
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7245A, B Plotter/Printer 
HP7245 Front and Rear Views 
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Figure 3-9. Front View 
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HP-IB 
Connection 


Figure 3-10. Rear View 
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Power ON/OFF 


The on/off switch is located to the right rear of the 
plotter. 


1. 


To turn the plotter on set the switch to 1. Setting the 
switch to O turns the plotter off. 


. The Line indicator light remains on and the pen/print 


head moves to the left margin of the paper. The 
paper advances until it finds the paging hold. 


Changing the Pen/Print Head 


ae 


The pen/print head is a long-life device. When it 
needs to be changed, refer to the 7245A Plotter/ 
Printer Operating and Programming Manual, P/N 
07245-90001 for instructions. 


Loading Paper 


ds, 


Open plastic window on front and metal hinged door 
on the top right side of the plotter. 


. Raise paper drive assembly all the way up, then pull 


lower idler assembly towards front of plotter. 


Insert roller into paper roll, place paper roll into 
cradle with the proper side out and seat roller. 


. Pull paper up and over the paper drive with at least 


six inches of paper extending beyond sprockets. 
Place the paper holes on left and right sprockets on 
the platen and then with rear sockets. 


. Close and seat the drum protector, lower paper 


drive back into place, and close the window and 
door. 


See the HP7245A Plotter/Printer Operating and 
Programming Manual, P/N 07245-90001, for additional 
information. 


7470A Plotter 


HP7470 Front and Rear Views 
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Figure 3-11. Front View 
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HP-IB 
Connection 





RS-232-C 
Connection 


Figure 3-12. Rear View 
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Power ON/OFF 
The on/off switch is located at the left rear of the plotter. 


1. Set the switch to on. 


2. The Error light comes on momentarily and the pen 
holder moves to the left pen stall. If there is no pen in 
the left stall, the pen holder moves to the right stall. 
When a pen is found, or if no pens are installed, the 
pen holder returns to a point near the right plotting 
limit. 


Loading Pens 


1. Raise the protective cover to gain access to the pen 
Stalls. 


2. Select a pen and remove its cap. 
3. Place the pen tip in the hole at the base of the stall 
and press down and in gently until the pen snaps 


into place. Repeat for the second pen. 


4. Lower the protective cover. 
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Loading Paper 


ts 


Move the Paper Loading Lever (below the left pen 
stall) to the Paper Load position. This raises the 
pinch wheels and the paper stop and stores and 
caps the pen. 


Place a sheet of paper on the platen surface so that 
it is against the paper stop and the left edge of the 
platen. 


_ Move the Paper Loading Lever to the Paper Hold 


position. This lowers the pinch wheels and the paper 
stop to secure the paper. 


Transparencies are loaded in the same way as 
paper. 


For further information on the HP7470A plotter, refer to 
the Operator's Manual, P/N 07470-90002. 


7580A/7585A * Drafting Plotter 
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Figure 3-13. Front View 


* This plotter is the same as the 7580A except it 
handles paper 12 inches wide. 
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Power ON/OFF 
The on/off switch is loaded on the front, lower left panel. 


1. To turn the power on press the switch to | (ON) 
position. The 0 (OFF) position turns the power off. 


2. When the switch is set to on, the Line and Chart 
Load lights come on and remain on. The pen moves 
approximately two inches to the right, then returns to 
pen initialization sensor at left end on the pen car- 
riage arm. 


Loading Pens and Carousels 

1. There are three types of pens available: fiber tip, 
roller ball, and drafting. A separate pen carousel is 
supplied for each type of pen. 


2. Select the pen type and color to be loaded into the 
corresponding pen carousel and remove the cap. 


3. Holding the carousel in one hand, place a pen so the 
tip flange is resting on the edge of the cap and the 
pen tip is over the opening. 


4. Press the pen down as you straighten it. Be careful 


that the tip clears the cap and the pen collar fits 
snugly into the notch on the hub of the carousel. 
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. Pull the plunger down and release it to assure the 


cap seals the pen tightly without binding. 
Repeat this procedure for the remaining seven pens. 
Insert pen carousel into carousel receptacle on the 


top left of the plotter. Rotate slightly until it drops into 
position on the spindle. No force is required. 


Loading Paper 


ae 


Set the Line switch to on. Raise the carriage cover. 
Position the paper so that its left edge is flush 
against both the front and back paper stops and 
hold in this position. 


. Manually position the right pinch wheel to align its 


scribe mark with the right paper edge. 


Close the carriage cover and press Chart Hold to 
lower the pinch wheels. (The plotter will not operate 
with the carriage cover raised.) 


For more information on the HP7580A Drafting Plotter 
refer to the Operating and Programming Manual, P/N 
07580-90000 and Operators Manual, P/N 07580-90002. 


9872A/B/S Plotter 
HP9872 Front and Rear Views 
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Figure 3-14. Front View 
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Figure 3-15. Rear View 


Power ON/OFF 2. Place the tip of the pen into the rubber cap at the 
bottom of the stall you want to use. Push the pen in 
gently until it snaps into place. Repeat this proce- 
dure for any other pen stall. 


The on/off switch is located at the lower right front of the 
plotter. 


1. Press the button in to turn the power on. Pressing the 


button a second time turns the power off. 3. To remove pen from the stall, press down on lever to 


the right of the pen. Grasp the pen firmly between 
thumb and forefinger and pull gently out of the pen 


Loading Pens Stall. 


1. Select a pen and move its cap. 
NOTE: Make sure that you place the right color of pen 


in the pen slot that matches the pen number 
you selected in HPDRAW. 
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Loading Paper (9872B) 


ils 


Press the Chart Load button to release the paper 
hold mechanism and move the plotter arm to the 

upper right corner of the platen. The Chart Load light 
comes on. 


. Place a sheet of paper on the platen surface so that 


itis against the ridge at the bottom of the platen and 
against the paper stop on the left side of the platen. 
Smooth the paper. 


Press the Chart Hold button to activate the hold- 
down mechanism. The Chart Load light goes off. 
Again smooth the paper. 


Transparencies are loaded in the same way as paper. 


Loading Paper (9872S) 


1. 


Store pens to avoid getting ink on the paper. Turn off 
the plotter. 


Press down on the paper stop on the left side of the 
platen and open both the left and the right paper 
supply modules by pressing the door latch buttons. 


Hold the paper roll in your left hand and load the roll 
between hubs in supply module with paper feeding 
across the top of the roll, aligning hub tabs with roll 
notches. 


Feed paper across table and under arm. 
Engage paper sprocket holes and sprockets at each 
end of take-up roller. Hold paper on roller while 


closing door. 


Close supply module door. Make sure paper is not 
on top of front edge guide. 


. Advance paper with thumbwheel! until taut. Turn 


plotter on and advance paper at least once with front 
panel buttons. The page advance option is auto- 
matically turned on when paper is loaded 
successfully. 


For more information on the HP9872B/S plotter, refer to 
the Operating and Programming Manual, part number 
09872-90008. 
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9872C, T Plotter 
HP9872 Front and Rear Views 
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Figure 3-16. Two Front Views 9872C and 9872T 
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HP-IB 
Connection 


Figure 3-17. Rear View 


Power ON/OFF 
The on/off switch is located at the lower front of the 
plotter. 


1. Press the button in to turn the plotter on. Pressing the 
switch again turns the plotter off. 


2. When the switch is on, the pen holder on the plotter 
arm moves to the lower right corner. 


Loading Pens 


af 


2: 


Select a pen and remove its cap. 


Place the tip of the pen into the rubber cap at the 
bottom of the stall you want to use. Push the pen in 
gently until it snaps into place. Repeat this proce- 
dure for any other pen stall. 


. To remove pen from the stall, press down on lever to 


the right of the pen. Grasp the pen firmly between 
your thumb and forefinger and pull gently out of the 
pen stall. 


nage Paper (9872T) 


. Set the on/off switch to off. Remove pen from the pen 
holder so ink does not get on your paper. 


. Press down on the paper stop on the left side of the 
platen. Open both left and right paper supply 
modules by pressing the door latch buttons. 


. Position roll paper between hubs in right supply 
module and align hub tabs with roll notches. Paper 
should feed across top of roll. 


. Engage paper sprocket holes on sprockets at end of 
roller. Hold paper while closing door. Make sure 
paper is not on top of paper guide at front edge of 
platen. 


. Advance paper with thumbwheel until taut. 


. Turn plotter switch to on, and press ADV HALF but- 
ton to advance the paper half a page. 


Loading Paper (9872C) 


a 


Set the on/off switch to on. Raise the paper stop on 
left side of the platen by pushing the upper portion of 
the stop with a pencil or pointed object. 


_ Press the Chart Load button. The Chart Load and 


Out of Limit lights should go on and the plotter arm 
and pen holder is moved to the upper right corner of 
the platen. 


_ Place a sheet of paper on platen with bottom under 


plastic lip and left side against the paper stop. Press 
Chart Hold push button. The Chart Load light should 
go out and Out of Limit light stays on. Smooth paper 
down using back of your hand. 


For more information on the HP9872C/T plotter, refer to 
the Graphics Plotter Operating and Programming 
Manual, P/N 09872-90011. 


Graphics Terminals 


You must have a graphics terminal to use HPDRAW. 
The three supported graphics terminals are the 
HP2623A, HP2647A/F, and HP2648A. Many keys on 
the three keyboards are located in different positions; 
however, the keys perform the same operations in 
HPDRAW. 


The major difference in the keyboards is the CTRL key 
on the HP2623A keyboard. This key is labelled CNTL on 
the HP2647 and HP2648 terminals. 


HP2647A, F and HP2648A Graphics 
Terminals 


some of the basic features that you need to be familiar 
with of the HP2647 and HP2648 graphics terminals are 
illustrated below. Keys and functions that relate spec- 
ifically to HPDRAW are explained in Section 1. 


For acomplete explanation of using your terminal, refer 
to the HP2647A User's Manual, P/N 02647-90001 or the 
HP2648A User's Manual, P/N 02648-90001. 


Power ON/OFF 
The on/off is located at the left rear of the terminal. 


1. Set the switch to the on position and the TERMINAL 
READY message appears in the upper left corner of 
your screen. 


2. Pressing the switch the opposite direction turns the 
terminal off. 


3. The power cord is located atthe left rear of the 
terminal next to the on/off switch. 


CPE RATING 
PBNGE 





On/Off 
Switch 


Figure 3-18. HP264X Rear View 
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HP2647A, F and HP2648A Keyboards 


The HP2647A, F and HP 2648A keyboards are made up 
of six groups: an alphanumeric keyboard, a terminal 
control group, function keys, edit group, display control 
group, and graphics control group. (See the photo for 
the location of each group for your specific terminal.) 


Terminal Control Group Function Keys 


; 


Alphanumeric 
Keyboard 


r. Peas 


Graphics 

Control 

Group 
2647A 


Figure 3-19. HP2647A, F Keyboard 
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Edit Group 
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Figure 3-20. HP2648A Keyboard 
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Terminal Control Group 

The REMOTE key is located in this group. The key is 
always pressed down to communicate with the 
computer. 


The CAPS LOCK key can be either up or down. With the 
key down you Can type all capital letters. With the key in 
the up position, you can type upper and lower case 
letters. 


The remaining keys should be in the up position. 


Function Keys 

The function keys for the HP2647A and the HP2648A 
Graphics Terminals perform the same functions; 
however, the keys are located in different positions on 
the keyboards. 


The function keys are numbered f1 through f8. These 
keys match the labels shown on the bottom of your 
terminal screen. 


Display Control Group 

The keys marked with an arrow move the cursor in the 
direction the arrow is pointing. By pressing these keys 
you can move the alphanumeric cursor to any position 
on the screen. 


The arrow in the center “homes” the cursor (puts it at 
the beginning of the first field). 


Graphics Control Group 

The keys marked with an arrow move the graphics 
cursor (+) in the direction the arrow is pointing. Use 
these keys to place HPDRAW objects in the location 
you choose. 


Pressing CURSOR FAST with one of the arrow keys 
moves the graphics cursor faster. 


Alphanumeric Keyboard 
The terminal keyboard works like a typewriter keyboard. 


See Section 1 for an explanation of the keys and how 
you use them with HPDRAW. 


Edit Group 

You use these keys to edit fields on a menu. See Sec- 
tion 1 for an explanation of the keys you can use with 
HPDRAW. 
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2623A Graphics Terminal 


Power ON/OFF 


The on/off switch is located at the right rear of the 
terminal. 


1. 


Set the switch to the on position and the cursor is 
displayed in screen column 1, row 1. Also, the 
primary function key labels are displayed across the 
bottom of the screen. 


To turn the terminal off, set the power switch to the 
OFF position. 


. The power cord is located at the right rear, below the 


power switch. 
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Connectors 


The keyboard connector is located at the left rear of the 
terminal. There is a label above the connector which 
indicates “KYBD”. 


There are two additional port connectors. Port 1 is used 
to connect your terminal with the port that communi- 
cates with the computer. 


Port 2 is used to connect another device such as a 
printer. 


On/Off Switch 
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Power 
Cord 
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Figure 3-21. HP2623A Rear View 
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HP2623A Keyboard 


The HP2623A keyboard consists of seven functional use with HPDRAW. For additional information on the 
groups. The Character set, Graphics Control, Function Terminal Control and Display Control groups, refer to 
Keys, Function Control Keys, and Edit group are briefly the HP2623A User's Manual, P/N 02623-90001. 
discussed here. Section 1 describes the keys you can 


Function 
Control . Edi 
evs Function Keys eraip 


Beh SLERS 
SARS. CHAR SSPE 
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aracter Set Group Control 


Group 


Figure 3-22. HP2623A Keyboard 
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Character Set Group 


The Character Set Group keys are located at the right of 
the keyboard. They control the graphics cursor. The 

four keys with an arrow move the graphics cursor (+) in 
the direction the arrow is pointing. Use these keys to 
place text or drawings in the work area. 


CURSOR FAST, when pressed simultaneously with one 
of the four cursor movement keys, moves the graphics 
Cursor at a higher speed. 


For the remaining Graphics Control keys functions, see 
Section 1 or the HP2623A User's Manual. 


Function Keys 

The Function Keys Group consists of eight keys located 
across the top of the keyboard. They are labelled f1 
through f8. These keys are associated with the eight 
function key labels across the bottom of your screen. 
For example, the second tabel from the left on your 
screen is associated with the f2 function key. You press 
f2 to perform the function of that label. 


Function Control Keys 


This group consists of the AIDS, MODES, and USER 
KEYS. Use these keys to select the functions available 
to the function keys, including the REMOTE key. See 
the 2623A Users Manual for a list of the functions 
available. 


Edit Group 

Information displayed in fields can be edited by using 
the Edit Keys. CLEAR DSPLY clears the display from 
the cursor position to the end of the last field. CLEAR 
LINE clears the line from the cursor to the end of the 
line. 


INS CHAR allows you to insert characters without 
overwriting existing characters. Place your cursor to the 
right of where you want your character inserted. This 
shifts the existing characters to the right one position for 
each character inserted. DEL CHAR deletes the 
character you position the Cursor under. 


For a complete explanation of using your terminal, refer 
to the HP2623A User's Manual, P/N 02623-90001. 
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Error Messages, Appendix C 

Examples of qualifying expressions, 3-15 
Exploding segments of a pie chart, 2-18 


Features of DSG/3000, 1-9 
FIGURE FILE Menu, 5-62 
Figure file menu, 5-62 
discussion, 5-62 
field explanation, 5-62 
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Moving from menu to menu, 4-10 
four basic loops, 4-10 
MPE file, 3-2 
Multi-color device, 1-9 


New Version of DSG/3000, 7-5 
Non-graphics terminal, 1-15, 1-20 


Operators and Functions used in Data 
Transformations, 5-59 
Optional pie chart enhancements, 4-17 
add labels, 4-17 
add titles or footnotes, 4-17 
annotate the chart, 4-17 
arrange the segments, 4-17 
explode a segment, 4-17 
label each segment, 4-17 
modify existing labels, 4-17 
redirect output to a plotter, 4-17 
specify colors or textures, 4-17 
specify size and color, 4-17 
Options, 2-11 
Order of procedures for designing 
a chart, 6-5 


P 


Parameter types, 7-1 

PASCAL examples, Appendix B 

Periodic use, 1-10 

PIE CHART LABELS Menu, 5-100 

Pie chart labels menu, 5-100 
discussion, 5-102 
field explanation, 5-100 
function keys, 5-104 
roadmap, 5-104 
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PIE CHART Menu, 5-105 
Pie chart menu, 5-105 
field explanation, 5-105 
function keys, 5-108 
Pie Chart Road Map, 4-12 
Pie chart titles menu, 5-109 
discussion, 5-110 
field explanation, 5-109 
function keys, 5-111 
roadmap, 5-112 
Pie chart with enhancements, 4-18 
Pie chart with exploded segment, 6-28 
Pie chart without enhancements, 4-14 
Pie chart, 4-12 
enhancing a pie chart, 4-19 
modifying a pie chart, 4-22 
Pie graph showing proportion, 2-8 
Pie Graph with Exploded Segment, 2-18 
Pie Graph, 1-6 
PIE TEXT CONTROL Menu, 5-113 
Pie Text Control, 5-113 
field description, 5-113 
function keys, 5-115 
Plotter and printer designators, 1-19 
Plotters and Terminals, Appendix G 
Power failure, 4-3 
Preparing program for new version, [7-5 
Procedure to design a chart, 6-5 


Procedures, 7-6 


GANOTINFO, 7-6 

GAXIS[A] SET/INQ, 7-8 
GBAR[A] SET/INQ, 7-13 
GCHARTINFO, 7-16 
GCHARTYPE SET/INQ, 7-17 
GCLOSEFILE, 7-19 
GCOPYCHART, 7-23 
GCREATECHART, 7-24 
GCREATEFILE, 7-27 
GDATAFILE SET/INQ, 7-30 
GDATAINFO, 7-33 

GDEFN SET/INQ, 7-35 
GDELCHART, 7-40 
GDELETEANOT, 7-41 
GDELETEFIGURE, 7-42 
GDEPVAR SET/INQ, 7-43 
GDEVICE SET/INQ, 7-47 
GERRORMSG, 7-49 
GEXECDATA, 7-50 
GEXECFIGURE, 7-54 
GEXECHART, 7-52 
GEXPLODE SET/INQ, 7-55 
GFONT SET/INQ, 7-58 
GGETCHART, 7-62 
GINDVAR SET/INQ, 7-65 
GINITGRAF, 7-68 

GLABEL SET/INQ, 7-71 
GLABVAR SET/INQ, 7-77 
GLEGEND SET/INQ, 7-78 
GLIMIT[A] SET/INQ, 7-84 
GLISTCHARTS, 7-87 


GNUMCHARTS, 7-88 
GOPENFILE, 7-89 
GPIE SET/INQ, 7-92 
GREADANOT[A], 7-95 
GSORT SET/INQ, 7-96 
GSUB SET/INQ, 7-98 
GSUPPRESS SET/INQ, 7-100 
GSYMBOL[A] SET/INQ, 7-103 
GTERMGRAF, 7-107 
GTEXTCONTROL SET/INQ, 7-114 
GTEXT[A] SET/INQ, 7-108 
GTITLE SET/INQ, 7-117 
GTRAN SET/INQ, 7-121 
Programmatic access, 1-10 
Programs, 
BASIC examples, Appendix B 
COBOL examples, Appendix B 
FORTRAN examples, Appendix B 
PASCAL examples, Appendix B 
SPL examples, Appendix B 
Purging a chart, 4-34 
Purpose of graphs, 2-1 
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Qualifications example, 5-119, 5-120 
QUALIFICATIONS Menu, 5-116 
Qualifications menu, 5-116 

discussion, 5-118 

field explanation, 5-116 

roadmap, 5-121 


Raster printers, 1-22 

Redirecting output, 1-21 

Repositioning output, 1-21 

RESET TERMINAL key, 1-17 

Results of Pie Labels 
Specifications, 5-1 

RS-232, 1-21 

Running DSG/3000 Interactively, 4-1 

Running GRAPH, 4-1 

Running the new version, 7-5 
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Scattergram, 1-7, 2-13 
Scattergram showing correlation, 2-10 
Screen Menus summary, 4-5 
Scrollable plotter, 1-9 
Security, 3-4 
Selecting a device, 1-19, 1-20 
SHIFT key, 1-16 
Showing correlation, 2-9 
Showing proportions, 2-7 
Slide, 1-8 
Slide Road Map, 4-33 
Special function key commands, 1-22 
for 2623A, 1-23 
for 2647A, 1-22 
for 2648A, 1-23 
Special Function keys, 4-1 
SPL examples, Appendix B 
Standard Titles for Line and Bar 
Charts, 5-14 
Steps in chart design, 4-10 
design a complete chart, 4-11 
draw the chart, 4-11 
modify a chart, 4-11 
Structuring the data file, 3-13 
Data manipulation order, 3-13 
Data qualifications, 3-14 
Subsetting a Data File, 3-17 


Summary of DSG/3000 Data Entry 
Methods, 3-1 

Summary of Screen Menus, 4-5 

Supplying chart information, 4-35 

Supported devices, 1-19 

Surface textures, 2-14 

System failure, 4-3 


TAB key, 1-16 
TDP/3000, 1-13 
Terminal and plotter combinations, 1-20 
Terminating, 
GRAPH, 4-4 
plotting, 4-3 
Text Angles, 5-3 
Textures, Appendix A 
Types of data and graphs, 2-3 
Types of DSG/3000 Graphs, 1-3 
Types of transformations, 1-14 
arithmetic operations, 1-14 
common functions, 1-14 
special functions, 1-14 
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Unprotected fields, 4-1 
User application programs, 1-10 
Using DS to access GRAPH, h-2 
Using DSG/3000 Programmatically, 6-1 
overview, 6-1 
Using Menus, 4-4 
Using procedures to, 6-5 
annotate a graph, 6-9 
control output, 6-7 
control text, 6-18 
create a figure file, 6-8 
design a bar chart, 6-12 
design a chart, 6-5 
design a line graph, 6-19 
design a pie chart, 6-23 
design a scattergram, 6-29 
produce a chart, 6-7 
Using QUERY to Build a Data File, 3-10 


Variables, 2-3 

dependent, 2-3 

independent, 2-3 
Vertical Clustered Bar Graph, 2-14 
Vertical Stacked Bar Graph, 2-15 
VPLUS/3000, 3-4 
VPLUS/3000 Example, 3-12 
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Window, message, 4-2 


x 


X-axis variable, 2-16 
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